十个必备的.NET开发小工具（7）：NDoc

最新推荐文章于 2022-03-05 21:45:55 发布

最新推荐文章于 2022-03-05 21:45:55 发布 · 67 阅读

文章标签：

编写代码文档是令人头疼的任务，NDoc工具可使用反射检查程序集，利用C# XML注释生成的XML文档自动为代码生成文档。借助VB Commenter能让Visual Basic.NET有XML注释功能。将程序集和XML文件加载到NDoc，定制输出后点击生成按钮，就能快速有效完成文档生成。

作者：James Avery 翻译：lucentoff

出处：http://msdn.microsoft.com/msdnmag/issues/04/07/MustHaveTools/default.aspx

声明：版权属原作者所有，转载请注明出处！

NDoc

<?xml:namespace prefix = o ns = "urn:schemas-microsoft-com:office:office" />

编写代码文档一直是一项令人生畏的任务。这里我并不是指设计初期的文档或更为详细的设计文档，而是指类中方法和属性的文档。NDoc工具能使用反射检查程序集并使用从C# XML注释生成的XML文档自动为你的代码生成文档。目前只有C#提供XML注释，但利用Visual Studio .NET小工具VB Commenter 可以使Visual Basic .NET具有XML注释功能。另外，Visual Studio的下一个发布版本将对更多的语言支持XML注释。

利用 NDoc ，你很容易在编写代码的同时形成文档（在 XML 注释中）。要使用 NDoc ，首先要在 Visual Studio.NET 中打开程序集的 XML 注释生成功能。右键点击项目，选择 Properties | Configuration Properties | Build ，然后在“ XML Documentation File ”项中输入保存 XML 文件的路径。当项目编译时，就会创建一个包括所有 XML 注释的 XML 文件。下面是 NUnit 范例中一个方法的 XML 文档：

该方法的XML文档将被抽取并保存到XML文件中，如下所示：

NDoc利用反射查看程序集，然后读取文档中的XML并进行匹配。NDoc可使用该数据创建各种不同的文档格式，包括MSDN风格的HTML帮助文件格式（.chm）、Visual Studio .NET 帮助文件格式（HTML Help 2）等。生成XML文件之后，下一步是将程序集和XML文件加载到NDoc中以便进行处理。操作很简单，只需打开NDoc并点击“Add”按钮，然后添加相关文件即可。