Visual Studio XML外部注释文件不起作用

Question

通过使用include标签,我试图将我的代码的注释放在单独的文件"docs.xml"中.但它不起作用.我一直在尝试C#和VB.NET项目.

这是我的评论文件:

<?xml version="1.0" encoding="utf-8" ?>
<d>
<summary>Demo summary</summary>
</d>

我有一个ABC类,有一个属性Demo.在我写这个属性之前:

/// <include file="docs.xml" path="d/*" />

或者在VB.NET中:

''' <include file="docs.xml" path="d/*" />

但是,ABC.Demo的摘要永远不会出现在InteliSense /对象浏览器/其他项目中(如果我引用我的项目).

我有一种强烈的感觉,我在这里遗漏了一些东西.

PS我试过遵循XML文件的"path [@ name =]"模式,但它没有帮助.

Answer 1

也许您已经在文档中看到了这一点，但如果我理解正确，您必须执行以下操作：

在 Visual Studio 中，您可以在项目设计器的“生成”窗格中指定XML 文档注释选项。当 C# 编译器看到该标记时，它将在 xml_include_tag.doc 而不是当前源文件中搜索文档注释。