.net - XML 注释——您如何(或在哪里)为您的命名空间和库创建 XML 注释？

Question

我明白，如果你///在类、字段、方法或属性上方 Visual Studio 将开始为您建立 XML 样式的注释。

但是，我在哪里可以为我的命名空间和/或库添加 XML 注释...

例如:

.NET Framework Class Library

System.Collections Namespaces

System.Collections Namespace

System.Collections.Concurrent Namespace

...

我不确定这些页面是手动创建的，还是通过在适当位置添加 XML 样式的注释自动创建的？

Answer 1

这取决于您用于生成文档的工具。与 NDoc ，我相信，您只需创建一个名为 NamespaceDoc 的类。在您想要记录的命名空间内。然后将使用该类的 XML 注释。

由于问题被标记为“sandcaSTLe”，我假设您确实在使用它。如果是这样，this SO answer应该给出详细信息。

更新:好吧，我只是 ( in that same thread ) 看到 SandcaSTLe 显然也理解 NamespaceDoc 类。有人可能想关闭这个问题作为重复。