淺析C#文檔自動化實現
作者：佚名
C#文檔自動化是什么概念？C#文檔自動化是如何實現的？C#文檔自動化的特點是什么呢？本問就向你介紹詳細內容。
C#文檔自動化了解之前我們先來了解什么是C#文檔自動化，熟悉java的程序員都知道，在java中有一種“文檔注釋”。采用這種注釋之后，使用相應的命令，我們就可以得到與代碼相關的文檔說明。如今，在.net的世界中C#也提供了相同的功能。如果結合相應的工具，它還可以為我們產生漂亮的WEB風格的文檔。
C#文檔自動化初步認識：
在C#中文檔注釋對應的符號是：///。但光使用它還是不能為我們產生代碼文檔，還必須使用特殊的標記才行。這些標記實際上是XML標記，最常用的是< summary >。例如：
- /// <summary>
- /// A method with a string array param.
- /// </summary>
- public void Koo(string[] ss) {}
C#文檔自動化的特點：
但是，并不是所有使用文檔注釋和這些標記的地方編譯器都會為我們生成文檔，它還會看這些標記是否與一些代碼結構相關聯。例如：
- /// <summary>
- /// 不產生這行
- /// </summary>
就不產生任何文檔。這些代碼結構必須是：class, struct, enum, method, property, field, indexer, delegate, 或event.
C#文檔自動化之產生文檔的命令
◆命令行：csc /doc: ….xml …..cs；
◆如使用VS.net，則：項目 -> 屬性 -> 配置屬性 -> 生成 -> 輸出 -> xml文檔文件(在此填寫文件名和路徑)；
◆如要生成web注釋：工具 ->生成注釋 web......。
C#文檔自動化的初步認識就向你介紹到這里，希望對你了解和學習C#文檔自動化有所幫助。
【編輯推薦】
責任編輯：仲衡
來源：
host01.com
