Visual Studio(2008)不生成文档xml

时间:2023-01-14 19:11:40

I have a C# dll project in Visual Studio 2008. In the project property pages, on the Build tab, the checkbox 'XML Documentation File' is checked. The path is 'bin\Debug\Fusion.BusinessObjects.XML' However, when building the solution, no xml files is created.

我在Visual Studio 2008中有一个C#dll项目。在项目属性页面的Build选项卡上,选中复选框'XML Documentation File'。路径为'bin \ Debug \ Fusion.BusinessObjects.XML'但是,在构建解决方案时,不会创建任何xml文件。

I have referenced this dll in a number of other projects, and one had a copy of the XML documentation file. This however only contained:

我在许多其他项目中引用了这个DLL,其中一个有XML文档文件的副本。但这仅包含:

<?xml version="1.0"?>
<doc>
    <assembly>
        <name>Fusion.BusinessObjects</name>
    </assembly>
    <members>
    </members>
</doc>

Why is the documentation file not generated? Needles to say, the code is documentented with comments like

为什么没有生成文档文件?有人说,这些代码的文档记录如下

/// <summary>
/// Helper class to construct a EntityCollection
/// </summary>

3 个解决方案

#1


It happened to me sometime ago and the way I corrected the problem was by recreating the project file from scratch and starting with a clean folder structure.

它发生在我的前一段时间,我纠正问题的方法是从头开始重新创建项目文件并从一个干净的文件夹结构开始。

#2


Are you sure you set that checkbox for Debug builds? By default it's only generated on Release builds. You might want to try a Release build and see if one is generated.

您确定为Debug版本设置了该复选框吗?默认情况下,它仅在发布版本上生成。您可能想尝试发布版本并查看是否生成了一个版本。

#3


The "XML documentation file" setting can have different values for different build configurations (debug/release). Is it possible that you've set it for debug (for example) but are doing a release build (or vice-versa)..?

“XML文档文件”设置可以针对不同的构建配置(调试/发布)具有不同的值。是否有可能将其设置为调试(例如)但正在进行发布构建(反之亦然)..?

#1


It happened to me sometime ago and the way I corrected the problem was by recreating the project file from scratch and starting with a clean folder structure.

它发生在我的前一段时间,我纠正问题的方法是从头开始重新创建项目文件并从一个干净的文件夹结构开始。

#2


Are you sure you set that checkbox for Debug builds? By default it's only generated on Release builds. You might want to try a Release build and see if one is generated.

您确定为Debug版本设置了该复选框吗?默认情况下,它仅在发布版本上生成。您可能想尝试发布版本并查看是否生成了一个版本。

#3


The "XML documentation file" setting can have different values for different build configurations (debug/release). Is it possible that you've set it for debug (for example) but are doing a release build (or vice-versa)..?

“XML文档文件”设置可以针对不同的构建配置(调试/发布)具有不同的值。是否有可能将其设置为调试(例如)但正在进行发布构建(反之亦然)..?