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 doc comments选项。 当C＃编译器看到标记时，它将在xml_include_tag.doc而不是当前源文件中搜索文档注释。