程序師世界是廣大編程愛好者互助、分享、學習的平台,程序師世界有你更精彩!
首頁
編程語言
C語言|JAVA編程
Python編程
網頁編程
ASP編程|PHP編程
JSP編程
數據庫知識
MYSQL數據庫|SqlServer數據庫
Oracle數據庫|DB2數據庫
 程式師世界 >> 編程語言 >> .NET網頁編程 >> C# >> C#入門知識 >> c#中//注釋和///注釋的區別,

c#中//注釋和///注釋的區別,

編輯:C#入門知識

c#中//注釋和///注釋的區別,


///會被編譯,
//不會
所以使用///會減慢編譯的速度(但不會影響執行速度)
///會在其它的人調用你的代碼時提供智能感知

 

C# Coding的時候,常常涉及代碼注釋,常見的注釋包括兩類:
1)單行注釋。格式:// Comments
2)多行注釋。格式:/* Comments... */
C#引入了新的XML注釋,即我們在某個函數前新起一行,輸入///,VS.Net會自動增加XML格式的注釋,這裡整理一下可用的XML注釋。
XML注釋分為一級注釋(Primary Tags)和二級注釋(Secondary Tags),前者可以單獨存在,後者必須包含在一級注釋內部。
I 一級注釋
1. <remarks>對類型進行描述,功能類似<summary>,據說建議使用<remarks>;
2. <summary>對共有類型的類、方法、屬性或字段進行注釋;
3. <value>主要用於屬性的注釋,表示屬性的制的含義,可以配合<summary>使用;
4. <param>用於對方法的參數進行說明,格式:<param name="param_name">value</param>;
5. <returns>用於定義方法的返回值,對於一個方法,輸入///後,會自動添加<summary>、<param>列表和<returns>;
6. <exception>定義可能拋出的異常,格式:<exception cref="IDNotFoundException">;
7. <example>用於給出如何使用某個方法、屬性或者字段的使用方法;
8. <permission>涉及方法的訪問許可;
9. <seealso>用於參考某個其它的東東:),也可以通過cref設置屬性;
10. <include>用於指示外部的XML注釋;
II 二級注釋
1. <c> or <code>主要用於加入代碼段;
2. <para>的作用類似HTML中的<p>標記符,就是分段;
3. <pararef>用於引用某個參數;
4. <see>的作用類似<seealso>,可以指示其它的方法;
5. <list>用於生成一個列表;
另外,還可以自定義XML標簽 

  1. 上一頁:
  2. 下一頁:
Copyright © 程式師世界 All Rights Reserved