Swashbuckle/Swagger .NET Core 字典<int, MyModel>

Question

我在使用 Swashbuckle 为 API 生成 Swagger 文档时遇到了一些问题，该 API 返回包含属性的自定义类型，该属性是值为 IEnumerable 的字典。

public class MyReturnModel
{
    public IDictionary<int, IEnumerable<MyModel>> Data { get; set;}

    public MyReturnModel()
    {
        Data = new Dictionary<int, IEnumerable<MyModel>>();
    }
}

public class MyModel
{
    public int Value { get; set; }
}

如果我有这样的 API 端点：

[ProducesResponseType(typeof(MyReturnModel), (int)HttpStatusCode.OK)]
[HttpGet]
public async Task<IActionResult> GetAsync()
{
    var myReturn = await MyReturnModelRepository.GetAsync();
    return Ok(myReturn);
}

我可以看到的 Swagger UI 显示响应类型如下：

MyReturnModel {
data (inline_model, optional)
}
inline_model {}

如何让 Swagger gen 为集合和内部模型生成文档？

Answer 1

答案是我使用的是 Swashbuckle 1.2.0 版。 更新到 2.0.0 版修复了这个问题。