visual-studio - ASP.NET Core 不创建 XML 注释文件

Question

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

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

Visual Studio 有一个生成 XML 文件的选项，但我如何从控制台执行此操作？

这是我的 ASP.NET Core 版本:

.NET Command Line Tools (1.0.0-preview2-1-003177)

Answer 1

对于 Visual Studio 2017 和 dotnet CLI，在 .csproj 文件中设置 DocumentationFile 属性将在相对于项目文件的指定路径生成 XML 文档。例如，要在与构建程序集相同的目录中生成 XML 文档，可以将以下属性组添加到项目文件中:

<PropertyGroup>
  <DocumentationFile>bin\$(Configuration)\$(TargetFramework)\MyProject.xml</DocumentationFile>
</PropertyGroup>

如果您只想为特定配置或平台构建它，请确保在属性组上设置适当的 Condition。