“///<exclude/>”是什么意思？

Question

我继承了一堆C#代码。在几个方法定义中，我发现///<exclude/>是前面唯一的XML文档注释。我尝试通过Google查找其含义，但没有成功。请问有人能够解释一下这可能意味着什么吗？

- Andreas

Answer 1

在NDoc中，它至少意味着应该排除此成员的XML文档。来自documentation：

<exclude/>标记指示NDoc从文档中排除当前项。

我不确定这最初是否是特定于NDoc的，但它似乎也被Sandcastle支持（因为它在Sandcastle XML注释指南中）。

- Jon Skeet

---

@Hanky웃Panky：回答那个问题：就是Jon Skeet（句号）！;-) - Andreas

我没有证据表明这个项目使用了 NDoc。也许在很久以前有人尝试过使用 NDoc。如果没有其他已知的使用情况，我会采纳 Jon 的答案。谢谢！ - Andreas

Answer 2

从Sandcastle Help File Builder 文档中得知：

通过命名空间摘要属性排除命名空间，或者因其XML注释包含<exclude />标记而排除项目。此信息将自动与API筛选器设置合并。要更改这些项目，您需要使用命名空间摘要属性或从项目的XML注释中删除该标记。

官方回复： 如何排除文档？ 有关行为的更多信息： 缺少成员和标记的问题

- Alex Filipovici

---

感谢您的回答。 - Andreas