2013-08-28 39 views
0

當你的C#代碼,代碼的xml文檔(不知道VB支持此與否),像這樣:如何生成我在C#中編碼爲Xml的文檔?

/// <summary> 
/// Gets or sets the identity of the Mail Server that is to be used to send the email. 
/// </summary> 
public string MailServer 
{ 
    get { return _mailServer; } 
    set { _mailServer = value; } 
} 

在三斜線註釋在XML獲取智能感知使用,但它似乎在早期版本的Visual Studio(2003我認爲)有一個工具可以檢查代碼,並將所有這些元素(以及對象名稱等)組裝成一個完整的Xml文檔。我無法在Visual Studio 2008,2010和2012中找到此工具。

我很高興開始學習如何使用Sandcastle以及所有這些,但這需要花費一些時間,而且我需要這些東西現在我正在嘗試製作一些文檔。

所以現在的問題是,因爲這個工具是在VS一次,它仍然存在,但我一直沒能找到它(obscurred)?或者我必須得到一個外部工具(最好是免費的)?

+2

[如何:生成一個XML項目文件(http://msdn.microsoft.com/en-us/library/vstudio/x4sa0ak0(V = VS.100 ).aspx) –

+0

那麼,你爲什麼不做出答案?它絕對是爲我回答這個問題的。 – Cyberherbalist

回答

2

生成XML文檔文件屬性決定是否一個 XML文件將彙編期間生成。您可以設置構建頁面項目設計的這個屬性 。當此選項 選擇,XML文檔被自動釋放到一個XML文件, 這將具有相同的名稱爲您的項目和.xml擴展名。

要生成一個Visual C#項目

  1. 隨着解決方案管理器中選擇一個項目一個XML文檔文件中,項目菜單上,單擊* Propertie * S。

  2. 點擊構建標籤。

  3. 在Build頁面上,選擇XML文檔文件。默認情況下,該文件指定的輸出路徑,例如, 的「bin \調試\ Projectname.XML」下創建。

http://msdn.microsoft.com/en-us/library/vstudio/x4sa0ak0(v=vs.100).aspx

+0

正是我在找的,謝謝! – Cyberherbalist

1

其實是有一個沙堡建設者,現在集成右到Visual Studio。它使得它很容易。 http://shfb.codeplex.com/

+0

這是一個很好的答案,事實上我昨天下載了這個項目,但還沒有想出如何使用它。 – Cyberherbalist

+0

您只需安裝它並在文檔下添加一個模板(在添加項目對話框中安裝的模板下)。將Sandcastle幫助文件生成器項目添加到解決方案,其餘的應該是平穩的航行。 –