XML注释 - 如何(或在何处)为命名空间和库创建XML注释？

Question

我理解,如果您///在类,字段,方法或属性之上,Visual Studio将开始为您创建XML样式的注释.

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

例如:

• .NET Framework类库
  • System.Collections命名空间
    1. System.Collections命名空间
    2. System.Collections.Concurrent命名空间
    3. ...

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

Answer 1

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

由于问题被标记为“sandcastle”，我假设您确实正在使用它。如果是这样，这个 SO 答案应该提供详细信息。

更新：好的，我刚刚（在同一个线程中）看到 Sandcastle 显然也理解 NamespaceDoc 类。有人可能想将这个问题作为重复问题来结束。