|
NDoc
編寫代碼文檔一直是一項令人生畏的任務。這里我并不是指設計初期的文檔或更為詳細的設計文檔，而是指類中方法和屬性的文檔。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文檔：
///
/// 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文件，因而以快速和有效的方式自動完成了煩人的任務。
| 
