[摘要]Build ,然后在“XML Documentation File”项中输入保存XML文件的路径。当项目编译时,就会创建一个包括所有XML注释的XML文件。下面是NUnit范例中一个方法的XML文档...
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文件中,如下所示:
This test adds a number of values to the Hashtable collection
and then retrieves those values and checks if they match.
NDoc利用反射查看程序集,然后读取文档中的XML并进行匹配。NDoc可使用该数据创建各种不同的文档格式,包括MSDN风格的HTML帮助文件格式(.chm)、Visual Studio .NET 帮助文件格式(HTML Help 2)等。生成XML文件之后,下一步是将程序集和XML文件加载到NDoc中以便进行处理。操作很简单,只需打开NDoc并点击“Add”按钮,然后添加相关文件即可。
一旦程序集和XML文件载入NDoc中并根据属性范围定制输出后,点击“Generate”按钮就开始生成文档。使用默认属性,NDoc会生成一些非常有用的.html和.chm文件,因而以快速和有效的方式自动完成了烦人的任务。
关键词:10个必备的.NET开发小工具(7):NDoc