如何在ASP.NET中包含Swagger中的XML註釋文件

Question

我需要Swagger生成API文檔包括UI以測試操作。

當我的項目中使用ASP.NET，XML的DEP文件的產生，一切都OK了，是這樣的： enter image description here

但是，當我在我的項目中使用ASP.NET核心，DEPS XML文件是不產生。它只是產生我的項目評論XML文件，看起來像這樣： enter image description here

而當我將我的項目部署到IIS，項目XML不在部署文件列表中。

Answer 1

爲每個項目啓用「XML文檔文件」複選框您需要在構建時生成其文件。它可以在項目的屬性「構建」選項卡上完成。

要包括上部署所有的XML文件，這個目標添加到發佈的項目的csproj文件：

<Target Name="PrepublishScript" BeforeTargets="PrepareForPublish"> 
    <ItemGroup> 
     <DocFile Include="bin\*\*\*.xml" /> 
    </ItemGroup> 
    <Copy SourceFiles="@(DocFile)" 
      DestinationFolder="$(PublishDir)" 
      SkipUnchangedFiles="false" /> 
</Target> 

這將從bin文件夾中的所有XML文件和嵌套子文件夾（如bin\Release\netcoreapp1.1\）複製到publish目錄。當然你可以定製這個目標。