c#程式編碼規範
選擇自 wirte 的 blog
關鍵字 c# 編碼規範
出處1.
目的
為了保證企業編寫出的程式都符合相同的規範,保證一致性、統一性而建立的程式編碼規範。
2.
範圍
適用於企業所有基於.net平台的軟體開發工作。
3.
規範內容
3.1.
**格式
u所有的縮排為4個空格,使用vs.net的預設設定。 u
在**中垂直對齊左括號和右括號。
if(x==0)
不允許以下情況:
if(x==0)
或者: if(x==0)
u u當一行被分為幾行時,通過將串聯運算子放在每一行的末尾而不是開頭,清楚地表示沒有後面的行是不完整的。
u每一行上放置的語句避免超過一條。
u在大多數運算子之前和之後使用空格,這樣做時不會改變**的意圖卻可以使**容易閱讀。
例: int j = i + k;
而不應寫為
int j=i+k;
u將大的複雜**節分為較小的、易於理解的模組。
u編寫 sql 語句時,對於關鍵字使用全部大寫,對於資料庫元素(如表、列和檢視)使用大小寫混合。 u
from customers
where state = 'wa'
3.2.
注釋(comment)規範
注釋規範包括:模組(類)注釋規範、類的屬性、方法注釋規範、**間注釋
3.2.1.模組(類)注釋規範
模組開始必須以以下形式書寫模組注釋:
//////模組編號:《模組編號,可以引用系統設計中的模組編號》
///作用:《對此類的描述,可以引用系統設計中的描述》
///編寫日期:《模組建立日期,格式:yyyy-mm-dd>
///如果模組有修改,則每次修改必須新增以下注釋:
//////log編號:
///修改描述:《對此修改的描述》
///修改日期:《模組修改日期,格式:yyyy-mm-dd>
///3.2.2.類屬性注釋規範
在類的屬性必須以以下格式編寫屬性注釋:
///
///屬性說明
///
3.2.3.方法注釋規範
在類的方法宣告前必須以以下格式編寫注釋
///
/// 說明:《對該方法的說明》
///
/// 《引數說明》
///
///《對方法返回值的說明,該說明必須明確說明返回的值代表什麼含義》
///
3.2.4.**間注釋規範
**間注釋分為單行注釋和多行注釋:
單行注釋:
//《單行注釋》
多行注釋:
**中遇到語句塊時必須新增注釋(if,for,foreach,……),新增的注釋必須能夠說明此語句塊的作用和實現手段(所用演算法等等)。
3.3.
變數(variable)命名規範
3.3.1.程式檔案(*.cs)中的變數命名規則
程式中變數名稱 = 變數的字首 +代表變數含意的英文單詞或單詞縮寫。 1.
類模組級的變數請用「m_」作字首
public class hello
2.類的屬性所對應的變數,採用屬性名前加「m_」字首的形式
public class hello }
} 3.
過程級的變數不使用字首
public class hello }
4.過程的引數使用「p_」作為引數
public class hello
}補充說明:
針對異常捕獲過程中的exception變數命名,在沒有衝突的情況下,統一命名為e;
如果有衝突的情況下,可以重複e,比如:ee。
trycatch(exceptionee) }
catch(exceptione)
補充:如果捕獲異常不需要作任何處理,則不需要定義exception例項
例: try
catch( exception )
5.鑑於大多數名稱都是通過連線若干單詞構造的,請使用大小寫混合的格式以簡化它們的閱讀。每個單詞的第乙個字母都是大寫.
6.即使對於可能僅出現在幾個**行中的生存期很短的變數,仍然使用有意義的名稱。僅對於短迴圈索引使用單字母變數名,如i
或j
。
7.在變數名中使用互補對,如 min/max、begin/end 和 open/close。
8.不要使用原義數字或原義字串,如for i = 1 to 7
。而是使用命名常數,如for i = 1 to num_days_in_week
以便於維護和理解。
3.3.2.控制項命名規則
控制項命名=web控制項縮寫字首 + 「_」 +變數名
控制項縮寫label
lbltextbox
txtcheckbox
chkbutton
cmdlistbox
lstdropdownlist
drp等等
3.4.
常量命名規範
常量名也應當有一定的意義,格式為 noun 或 noun_verb。常量名均為大寫,字之間用下劃線分隔。
例: private const bool
web_enablepagecache_default
= true;
private const int
web_pagecacheexpiresinseconds_default = 3600;
private const bool
web_enablessl_default
= false;
注:變數名和常量名最多可以包含 255 個字元,但是,超過 25 到 30 個字元的名稱比較笨拙。此外,要想取乙個有實際意義的名稱,清楚地表達變數或常量的用途,25 或 30 個字元應當足夠了。
3.5.
類(class)命名規範
1.名字應該能夠標識事物的特性。
2.名字盡量不使用縮寫,除非它是眾所周知的。
3.名字可以有兩個或三個單詞組成,但通常不應多於三個。
4.在名字中,所有單詞第乙個字母大寫。
例如 issuperuser,包含id的,id全部大寫,如customerid。
5.使用名詞或名詞短語命名類。
6.少用縮寫。
7.不要使用下劃線字元 (_)。
例:
public classfilestream
public classbutton
public classstring
3.6.
介面(inte***ce)命名規範
和類命名規範相同,唯一區別是 介面在名字前加上「i」字首
例:inte***ce idbcommand;
inte***ce ibutton;
3.7.
方法(method)命名規範
和類命名規範相同。
3.8.
命名空間(namespace)命名規範
和類命名規範相同。
C 程式編碼規範
1.目的 為了保證企業編寫出的程式都符合相同的規範,保證一致性 統一性而建立的程式編碼規範。2.範圍 適用於企業所有基於.net平台的軟體開發工作。3.規範內容 3.1.格式 u 所有的縮排為4個空格,使用vs.net的預設設定。u 在 中垂直對齊左括號和右括號。if x 0 不允許以下情況 if ...
C 編碼規範
c 編碼規範 規範的制定原則 1 參照微軟在vs.net中,c 既有的規範來制定 2 方便 的交流和維護。3 不影響編碼的效率,不與大眾習慣衝突。4 使 更美觀 閱讀更方便。5 使 的邏輯更清晰 更易於理解。規範的遵守原則 1 如果是軟體外包專案,並且對方制定了 的編寫規範,則首先要遵守對方的編碼規...
C 編碼規範
c 編碼規範 1.目的 為了保證企業編寫出的程式都符合相同的規範,保證一致性 統一性而建立的程式編碼規範。2.範圍 適用於企業所有基於.平台的軟體開發工作。3.規範內容 3.1.格式 u 所有的縮排為4個空格,使用vs.的預設設定。u 在 中垂直對齊左括號和右括號。if x 0 不允許以下情況 if...