紹

　　在這個(gè)實(shí)踐練習(xí)中，你將在C#源文件中插入XML注釋，然后通過C#編譯器生成XML文件。你可以在C#源代碼中使用XML相關(guān)的注釋標(biāo)記，這些標(biāo)記被用來指明哪些注釋需要輸出到XML文件。

　　XML文件可以作為代碼文檔。你可以在現(xiàn)存的文件中加入新的注釋，或者修改現(xiàn)有注釋，以保持文檔和它對(duì)應(yīng)代碼的一致性。為了創(chuàng)建一個(gè)更新的文檔記錄，你要重新生成XML文件。

　　在本練習(xí)中，你將要:

　　 · 使用微軟Visual Studio.NET集成開發(fā)環(huán)境創(chuàng)建和編輯一個(gè)項(xiàng)目文件

　　 · 創(chuàng)建一個(gè)XML文件(doc.xml)

　　 · 在IDE中打開項(xiàng)目和源文件

　　 · 用MS-DOS命令編譯項(xiàng)目

　　 · 在XML文件中應(yīng)用XSL模板

　　 · 打開doc.xml最終版本

　　在IDE中創(chuàng)建一個(gè)新的項(xiàng)目

　　1．點(diǎn)擊Start，點(diǎn)擊Programs，點(diǎn)擊Microsoft Visual Studio.NET7.0，然后再點(diǎn)擊Microsoft Visual Studio .NET 7.0。IDE啟動(dòng)頁面就會(huì)顯示，如圖1。

   
　　　　　　　　圖1 Visual Studio.NET IDE啟動(dòng)頁面
　　注意：

　　當(dāng)你用這種方法啟動(dòng)IDE時(shí)，缺省啟動(dòng)頁面就會(huì)打開。它提供了在此工作環(huán)境下的最近四個(gè)項(xiàng)目的鏈接，還提供了一些其它資源的鏈接。

　　你可以改變你的缺省設(shè)置。點(diǎn)擊Tools，再點(diǎn)擊Options，然后選擇你喜歡的設(shè)置。

　　2．點(diǎn)擊File，點(diǎn)擊New，再點(diǎn)擊Project。New Project窗口就會(huì)出現(xiàn)，如圖2。

　　3．在Project Types面板里點(diǎn)擊Visual C# Projects，在Templates面板上中點(diǎn)擊Empty Project。

　　4．在Name字段中，鍵入XML Comments，然后選擇你的項(xiàng)目存放的位置(在本操作中我們使用缺省位置)。

　　　　注意：在這個(gè)項(xiàng)目名中,"XML"與"Comments"中間有一個(gè)空格。

　　5．點(diǎn)擊OK。

   
　　　　　　　　　　　圖2. New Project窗口 
 
創(chuàng)建XMLComment.cs源文件

　　XMLComment.cs文件是用來創(chuàng)建XML文檔的源文件。XML標(biāo)簽及其相關(guān)文本在C#代碼中被注釋掉了。此源文件在編譯時(shí)，就通過這些XML標(biāo)簽和文本生成XML文檔。

　　注意：

　　XML注釋標(biāo)記是新加入C#的。在文本前面以三斜杠（///）打頭，它會(huì)告訴編譯器斜杠后面的文本是XML注釋。我們必須以三斜杠開頭以聲明這一行為XML注釋行。XML注釋必須采用XML標(biāo)簽的格式，這樣才能生成XML文檔。

　　1．點(diǎn)擊File，再點(diǎn)擊Add New Item。Add New Item窗口將顯示如圖3。

　　2．在Categories面板里點(diǎn)擊Local Project Items，在Templates面板中點(diǎn)擊Code File。

　　3．在name字段中鍵入XMLComment.cs。

　　　注意："XMLComment.cs"中間沒有空格.

   
　　　　　　　　　　圖3.Add New Item窗口

　　4．點(diǎn)擊Open.

　　5．在頁面中敲入下面的代碼：

    using System;

class XmlElement
{
///
/// Returns the attribute with the given name and
/// namespace
///

/// The name of the attribute
///

/// The namespace of the attribute, or null if
/// the attribute has no namespace
///
/// The attribute value, or null if the attribute
/// does not exist
///
public string GetAttr(string name, string ns) {
return "test";
}
}
　　6．點(diǎn)擊File，再點(diǎn)擊Save XMLComments.cs（或點(diǎn)擊Save圖標(biāo)）。該文件就被存到你的項(xiàng)目文件夾中。

　　7．點(diǎn)擊File，再點(diǎn)擊Exit。如果Microsoft Development窗口出現(xiàn)，點(diǎn)擊Yes保存你的項(xiàng)目。
 
在IDE中打開項(xiàng)目和源文件

　　1．點(diǎn)擊Start，點(diǎn)擊Programs，點(diǎn)擊Microsoft Visual Studio.NET7.0，然后再點(diǎn)擊Microsoft Visual Studio .NET 7.0。

　　2．點(diǎn)擊File，點(diǎn)擊Open，再點(diǎn)擊Project。

　　3．打開路徑C:\Documents and Settings\Administrator\My Documents\Visual Studio Projects\XMLComments

　　4．點(diǎn)擊XMLC