您好,登錄后才能下訂單哦!
這篇文章將為大家詳細講解有關C#中怎么實現自動化文檔,文章內容質量較高,因此小編分享給大家做個參考,希望大家閱讀完這篇文章后對相關知識有一定的了解。
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#中怎么實現自動化文檔就分享到這里了,希望以上內容可以對大家有一定的幫助,可以學到更多知識。如果覺得文章不錯,可以把它分享出去讓更多的人看到。
免責聲明:本站發布的內容(圖片、視頻和文字)以原創、轉載和分享為主,文章觀點不代表本網站立場,如果涉及侵權請聯系站長郵箱:is@yisu.com進行舉報,并提供相關證據,一經查實,將立刻刪除涉嫌侵權內容。