c# - "/// 是什么意思“ 意思是？

Question

我继承了一堆 C# 代码。对于几个方法定义，我发现///<exclude/>它是它前面唯一的 XMLDoc。我试图用谷歌搜索它的含义，但没有成功。有人可以解释一下这可能意味着什么吗？

Answer 1

至少在NDoc中，这意味着应该排除该成员的 XML 文档。从文档中：

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

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

Answer 2

从Sandcastle 帮助文件生成器 文档：

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

官方回复：

排除文档的方法？

以及有关该行为的更多信息：

缺少成员和标签的问题