.net - .net XML 文档注释包括沙堡中的指令未添加到帮助文件中

Question

有一个有趣的。我正在使用 C# 中的 XML 文档注释记录一个方法。我想使用该指令来包含引用文件的所有内容。我正在记录一段代码，它接收格式化为 xml 文档的字符串，并且我想在参数文档中包含 XSD 文件。

这很好用，因为 Visual Studio 生成的 XML 符合我的预期。这是 XML 的一个片段：

    /// <param name="xml">XML string - see Test.xsd <include file="XSD/Test.xsd" path="/*"/> After file include</param>

但是，当我使用 Sandcastle 从中生成帮助文件时，没有显示 xsd 文件的内容，但 Sandcastle 没有报告任何错误。我尝试使用相对于帮助文件所在位置的文件名，即

但随后 Visual Studio 抱怨它找不到该文件。我把它们放在两个地方，仍然没有出现包含的文件。

有任何想法吗？

Answer 1

include 标记在编译器时进行处理，因此生成的 XML 文件应该包含其所有引用的内容。因此，您必须将您的 XSD 文件夹相对于 C# 源文件放置，这样编译器就不会显示任何错误。在此之后，Sandcastle 将能够从单个 XML 文档创建帮助文件。