如何使用<包括>在external comments.xml文件中引用另一个成员

本文关键字:文件 xml 引用 成员 另一个 comments external 何使用 包括 | 更新日期: 2023-09-27 18:06:31

我知道如何使用关键字从我的代码引用外部注释文件中的成员。比如:

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

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

我试过同样的格式,但它不起作用。什么好主意吗?

ETA:根据这篇博客文章,"原因3",它应该使用完全相同的语法,所以我不确定为什么它不适合我。如果我查看visual studio生成的xml文件,没有生成任何错误。事实上,它看起来不像它甚至试图包括成员,因为我原来的'include'行仍然在那里(但是'path'部分出现在'file'部分之前)。

ETA2:我必须修复上述博文中的c#示例,将include-includes拆分为一个单独的xml文件,否则编译时会产生stockoverflow。
然而,我不能让它为我工作。我正在使用VB,我已经在2008年和2010年测试了它——两者都是express版本。这意味着要么语法不同,要么功能没有在visual studio的VB版本中实现。

如何使用<包括>在external comments.xml文件中引用另一个成员

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

例如:

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