【www.gdgbn.com--.Net开发】

　　编写代码文档资料几乎总是一项令人畏惧的任务。我所说的不是早期设计文档，甚至也不是更为详细的设计文档；我说的是记录类上的各个方法和属性。 NDoc 工具能够使用反射来分析程序集，并使用从 C# XML 注释生成的 XML 自动为代码生成文档资料。XML 注释仅适用于 C#，但有一个名为 VBCommenter 的 Visual Studio .NET Power Toy，它能够为 Visual Basic .NET 完成类似的工作。此外，下一版本的 Visual Studio 将为更多语言支持 XML 注释。

　　使用 NDoc 时，你仍然在编写代码的技术文档，但你是在编写代码的过程中完成了文档编写工作（在 XML 注释中），而这更容易忍受。使用 NDoc 时，第一步是为你的程序集打开 XML 注释生成功能。右键单击该项目并选择 Properties | Configuration Properties | Build，然后在 XML Documentation File 选项中输入用于保存 XML 文件的路径。当该项目生成时，将创建一个 XML 文件，其中包含所有 XML 注释。下面是 NUnit 示例中的一个用 XML 编写了文档的方法：



/// 
/// This test adds a number of values to the Hashtable collection 
/// and then retrieves those values and checks if they match.
/// 
[Test]
public void HashtableAddTest()
{
//Method Body Here
}


　　有关该方法的 XML 文档资料将被提取并保存在 XML 文件中，如下所示：




本文来源：http://www.gdgbn.com/asp/13015/