c# - Web Api 中用于端点和类文档的 Swagger UI 设置

Question

我在 VS2013 中有一个解决方案，其中包含多个类库和一个 Web API 项目。我在设置 Swagger UI 时遇到了一些问题。首先，当我为我的 Web API 项目设置 swashbuckle 时，我只能指向一个文档 XML 文件。有没有一种方法可以指向包含多个 XML 文件，这样 Swagger 不仅可以在 Controller 中获取我的路由文档，还可以从我的其他项目中获取域对象？这是我来自 SwaggerConfig.cs 的代码

SwaggerSpecConfig.Customize
    (
        c =>
        {
            c.IncludeXmlComments(Path.Combine(dirPath, projName + ".xml"));
        }
    );

如果我添加多个 XML 文件，它只会从 IncludeXmlComments 中选取最后一个文件。

其次，我在 JSON 中返回时为我的 DTO 使用驼峰式大小写

formats.JsonFormatter.SerializerSettings.ContractResolver = new CamelCasePropertyNamesContractResolver();

但是，当我在 Swagger UI 的响应类中查看响应模型和模型模式时，我看到了确切的类属性名称，而不是命中端点时返回的 JSON 模式。有没有办法在 Swagger UI 文档页面中显示确切的 JSON 模式？

Answer 1

我使用的是 5.6.0 版，多个 XML 文档适用于我:

var dir = new DirectoryInfo(Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "bin"));
foreach (var fi in dir.EnumerateFiles("*.xml"))
{
    c.IncludeXmlComments(fi.FullName);
}