1

我知道如何使用代码中的 <include> 关键字来引用外部注释文件中的成员。就像是:

<include file="Comments.xml" path="Docs/ClassName/Members[@name='DoIt']/*" />

但是,我在 Comments.xml 文件中有重复的成员,我想将它们拆分出来并在 Comments.xml 文件本身中引用。例如,它可以是多次使用的参数定义。

我已经尝试过与上述相同的格式,但它不起作用。有任何想法吗?

ETA:根据这篇文“原因 3”,它应该使用完全相同的语法,所以我不确定为什么它不适合我。如果我查看 Visual Studio 生成的 xml 文件,则没有生成错误。事实上,它看起来甚至没有尝试包含该成员,因为我原来的“包含”行仍在其中(但“路径”部分出现在“文件”部分之前)。

ETA2:我必须修复上述博客文章中的 c# 示例,以将包含包含拆分为单独的 xml 文件,否则在编译时会生成 stockoverflow。
但是,我无法让它为我工作。我正在使用 VB,我在 2008 年和 2010 年对其进行了测试——两​​者都是速成版。这意味着语法不同,或者功能未在 Visual Studio 的 VB 版本中实现。

4

1 回答 1

0

似乎您希望在您的 xml 文件中有一个元素,该元素包含在一个类的所有成员的文档中?我以前做过,但我认为我没有让元素在 xml 文件中工作。我的解决方案是在我的 c# 代码中包含多个元素。

例如:

/// <include file="Comments.xml" path="Docs/ClassName/AllMembers/*" />
/// <include file="Comments.xml" path="Docs/ClassName/Members[@name='DoIt']/*" />
于 2011-12-05T16:47:36.097 回答