.net – 如何在项目文件构建的NuGet包中包含XML文档文件？

发布时间：2020-12-16 23:49:57 所属栏目：百科来源：网络整理

导读：我认为通常优良的做法是将包含在NuGet包中的C#build生成的 XML文档文件与DLL一起包含,以便为消费者提供智能感知文档. 但是,我不清楚在使用VS 2017的项目文件格式构建软件包时如何做到这一点. 这可能吗？显然我可以切换到维护一个nuspec文件,但VS2017格式非

我认为通常优良的做法是将包含在NuGet包中的C#build生成的 XML文档文件与DLL一起包含,以便为消费者提供智能感知文档.

但是,我不清楚在使用VS 2017的项目文件格式构建软件包时如何做到这一点.

这可能吗？

显然我可以切换到维护一个nuspec文件,但VS2017格式非常方便将版本和依赖项保存在一个地方.

只要在csproj文件中设置GenerateDocumentationFile,就像这样：

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <TargetFramework>netstandard2.0</TargetFramework>
    <GenerateDocumentationFile>true</GenerateDocumentationFile>
  </PropertyGroup>

</Project>

然后所有默认值将在正确的位置生成文档文件,它将包含在NuGet包中.

如果Visual Studio添加了DocumentationFile或其他元素,则可以删除它们并将其替换为单个GenerateDocumentationFile属性.

（编辑：李大同）

【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容!