coding的時候,常常涉及**注釋,常見的注釋包括兩類:
1)單行注釋。格式:// comments
2)多行注釋。格式:/* comments… */
c#引入了新的注釋,即我們在某個函式前新起一行,輸入///,會自動增加格式的注釋,這裡整理一下可用的xml注釋。
xml注釋分為一級注釋(primary tags)和二級注釋(secondary tags),前者可以單獨存在,後者必須包含在一級注釋內部。
i 一級注釋
1. 對型別進行描述,功能類似,據說建議使用;
2. 對共有型別的類、方法、屬性或字段進行注釋;
3. 主要用於屬性的注釋,表示屬性的制的含義,可以配合使用;
4. 用於對方法的引數進行說明,格式:value;
5. 用於定義方法的返回值,對於乙個方法,輸入///後,會自動新增、列表和;
6. 定義可能丟擲的異常,格式:;
7. 用於給出如何使用某個方法、屬性或者欄位的使用方法;
8. 涉及方法的訪問許可;
10. 用於指示外部的xml注釋;
ii 二級注釋
1. or主要用於加入**段;
2. 的作用類似html中的標記符,就是分段;
3. 用於引用某個引數;
4. 的作用類似,可以指示其它的方法;
5. 用於生成乙個列表;
另外,還可以自定義xml標籤。
的正確使用 眼霜正確的使用方法
眼睛周圍的肌膚是乙個人整張臉上最脆弱的部分,它嬌嫩柔弱,只要有稍稍的護理不慎,就會帶來不堪設想的後果,黑眼圈 眼袋之類的問題更是家常便飯了。我們可以使用日常眼霜保護眼周肌膚,緩解眼周肌膚的問題。然而,對於日常眼霜的使用,你知道多少,有一些你所不知道的錯誤用法,你是不是也中招了 日常眼霜的作用 日常眼...
QThread的正確使用方法
qt自帶的文件和例子中使用qthread都是繼承qthread,然後過載run,今天想在繼承自qthread類中自定義乙個槽,覺得對qthread的訊號 槽的機制在多執行緒的情況下有些不清楚的地方,猜想qthread的槽並不是執行在qthread例項建立的子執行緒中,但我需要讓槽執行在子執行緒中,查...
Svn正確的使用方法
第三種情況 如果svn update時發生了衝突 conflict 會產生三個檔案 乙個是.mine 本地版本,乙個是.r101,你的工作基準版本,乙個是.r102,伺服器端的最新版本。則手工修改衝突,然後先svn resolved,注意這是告訴svn你已經解決了衝突。然後執行下一步svn comm...