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

Question

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

https://docs.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 和dotnetCLI，DocumentationFile在 .csproj 文件中设置属性将在指定路径（相对于项目文件）生成 XML 文档。例如，要在与构建的程序集相同的目录中生成 XML 文档，您可以将以下属性组添加到项目文件中：

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

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