ASP.NET Core 服务器中如何包含 Swagger XML 注释文件？答案

【问题标题】：How are Swagger XML comment files included in the ASP.NET Core server?ASP.NET Core 服务器中如何包含 Swagger XML 注释文件？
【发布时间】：2019-04-07 13:49:58
【问题描述】：

我将 Swashbuckle 用于 API 文档，这需要输出中的 projectname.xml 文档，但是当我构建我的 ASP.NET Core 项目时，我没有得到该文件。

https://docs.microsoft.com/en-us/aspnet/core/tutorials/web-api-help-pages-using-swagger

在服务器上发布时应该怎么做？

var xmlFile = "${System.Reflection.Assembly.GetExecutingAssembly().GetName().Name}.xml";
c.IncludeXmlComments(System.IO.Path.Combine(AppContext.BaseDirectory, xmlFile));

【问题讨论】：

您是否按照docs中的说明进行操作？

标签： asp.net-core swagger

【解决方案1】：

为了从代码 cmets 生成 XML 文档。您需要打开所有项目的项目属性，转到 Build 选项卡，然后检查 XML 文档文件。这将确保在指定位置生成 XML 文档。您需要为输出目录使用相对路径。

【讨论】：