C#編程規(guī)范--精選文檔

1、1 概述1.1 規(guī)范制定原則n 方便代碼的交流和維護(hù)。n 不影響編碼的效率，不與大眾習(xí)慣沖突。n 使代碼更美觀、閱讀更方便。n 使代碼的邏輯更清晰、更易于理解。1.2 術(shù)語定義n Pascal 大小寫 將標(biāo)識符的首字母和后面連接的每個單詞的首字母都大寫?？梢詫θ址蚋嘧址臉?biāo)識符使用Pascal 大小寫。例BackColorn Camel 大小寫 標(biāo)識符的首字母小寫，而每個后面連接的單詞的首字母都大寫。例如：backColor2 代碼外觀2.1 列寬 代碼列寬控制在110字符左右，原則上不超過屏寬。2.2 換行 當(dāng)表達(dá)式超出或即將超出規(guī)定的列寬，遵循以下規(guī)則進(jìn)行換行：n 在逗號，括號后換行

2、。n 在操作符前換行。n 規(guī)則1優(yōu)先于規(guī)則2。 當(dāng)以上規(guī)則會導(dǎo)致代碼混亂的時候自己采取更靈活的換行規(guī)則。2.3 縮進(jìn) 縮進(jìn)應(yīng)該是每行一個Tab(4個空格)，不要在代碼中使用Tab字符。 Visual Studio.Net設(shè)置：工具->選項(xiàng)->文本編輯器->C#->制表符->插入空格2.4 空行空行是為了將邏輯上相關(guān)聯(lián)的代碼分塊，以便提高代碼的可閱讀性。在以下情況下使用兩個空行：n 接口和類的定義之間。n 枚舉和類的定義之間。n 類與類的定義之間。 在以下情況下使用一個空行：n 方法與方法、屬性與屬性之間。n 方法中變量聲明與語句之間。n 方法與方法之間。n 方法中

3、不同的邏輯塊之間。n 方法中的返回語句與其他的語句之間。n 屬性與方法、屬性與字段、方法與字段之間。n 注釋與它注釋的語句間不空行，但與其他的語句間空一行。n 文件之中不得存在無規(guī)則的空行，比如說連續(xù)十個空行?？招惺菫榱藢⑦壿嬌舷嚓P(guān)聯(lián)的代碼分塊，以便提高代碼的可閱讀性。2.5 空格在以下情況中要使用到空格：n 關(guān)鍵字和左括符 “(” 應(yīng)該用空格隔開。如 while (true) 注意在方法名和左括符 “(” 之間不要使用空格，這樣有助于辨認(rèn)代碼中的方法調(diào)用與關(guān)鍵字。n 多個參數(shù)用逗號隔開，每個逗號后都應(yīng)加一個空格。n 除了 . 之外，所有的二元操作符都應(yīng)用空格與它們的操作數(shù)隔開。一元操作符、+

4、及-與操作 數(shù)間不需要空格。如 a += c + d; a = (a + b) / (c * d); while (d+ = s+) n+; PrintSize(“size is “ + size + “n”);n 語句中的表達(dá)式之間用空格隔開。如for (expr1; expr2; expr3)2.6 花括號 - n 左花括號 “” 放于關(guān)鍵字或方法名的下一行并與之對齊。如 if (condition) public int Add(int x, int y) n 左花括號 “” 要與相應(yīng)的右花括號 “”對齊。n 通常情況下左花括號 “”單獨(dú)成行，不與任何語句并列一行。n if、while、

5、do語句后一定要使用，即使號中為空或只有一條語句。如 if (somevalue = 1) somevalue = 2; n 右花括號 “” 后建議加一個注釋以便于方便的找到與之相應(yīng)的 。如 while (1) if (valid) / if valid else / not valid / end forever3 程序注釋3.1 注釋概述n 修改代碼時，總是使代碼周圍的注釋保持最新。n 在每個例程的開始，提供標(biāo)準(zhǔn)的注釋樣本以指示例程的用途、假設(shè)和限制很有幫助。注釋樣本應(yīng)該是解釋它為什么存在和可以做什么的簡短介紹.n 避免在代碼行的末尾添加注釋；行尾注釋使代碼更難閱讀。不過在批注變量聲明時，

6、行尾注釋是合適的；在這種情況下，將所有行尾注釋在公共制表位處對齊。 n 避免雜亂的注釋，如一整行星號。而是應(yīng)該使用空白將注釋同代碼分開。 n 在部署發(fā)布之前，移除所有臨時或無關(guān)的注釋，以避免在日后的維護(hù)工作中產(chǎn)生混亂。n 如果需要用注釋來解釋復(fù)雜的代碼節(jié)，請檢查此代碼以確定是否應(yīng)該重寫它。盡一切可能不注釋難以理解的代碼，而應(yīng)該重寫它。盡管一般不應(yīng)該為了使代碼更簡單以便于人們使用而犧牲性能，但必須保持性能和可維護(hù)性之間的平衡。n 在編寫注釋時使用完整的句子。注釋應(yīng)該闡明代碼，而不應(yīng)該增加多義性。 n 在編寫代碼時就注釋，因?yàn)橐院蠛芸赡軟]有時間這樣做。另外，如果有機(jī)會復(fù)查已編寫的代碼，在今天看來很

7、明顯的東西六周以后或許就不明顯了。n 避免多余的或不適當(dāng)?shù)淖⑨?，如幽默的不主要的備注。n 使用注釋來解釋代碼的意圖。它們不應(yīng)作為代碼的聯(lián)機(jī)翻譯。 n 注釋代碼中不十分明顯的任何內(nèi)容。n 為了防止問題反復(fù)出現(xiàn)，對錯誤修復(fù)和解決方法代碼總是使用注釋。n 對由循環(huán)和邏輯分支組成的代碼使用注釋。這些是幫助源代碼讀者的主要方面。 n 在整個應(yīng)用程序中，使用具有一致的標(biāo)點(diǎn)和結(jié)構(gòu)的統(tǒng)一樣式來構(gòu)造注釋。 n 在所有的代碼修改處加上修改標(biāo)示的注釋。3.2 文件頭注釋說明所有文件開始添加如下注釋， /*- * 單元名稱： * 單元描述： * 創(chuàng)建人： * 創(chuàng)建日期： * 修改日志 * 修改人 修改日期 修改內(nèi)容

8、* * -*/3.3 文檔型注釋該類注釋采用.Net已定義好的Xml標(biāo)簽來標(biāo)記，在聲明接口、類、方法、屬性、字段都應(yīng)該使用該類注釋，以便代碼完成后直接生成代碼文檔，讓別人更好的了解代碼的實(shí)現(xiàn)和接口。如/<summary>MyMethod is a method in the MyClass class./<para>Here's how you could make a second paragraph in a description./<see cref="System.Console.WriteLine"/> /for in

9、formation about output statements./</para> /<seealso cref="MyClass.Main"/> /</summary> public static void MyMethod(int Int1) 3.4 單行注釋該類注釋用于n 方法內(nèi)的代碼注釋。如變量的聲明、代碼或代碼段的解釋。注釋示例： / 注釋語句 private int number;n 方法內(nèi)變量的聲明或花括號后的注釋, 注釋示例： if ( 1 = 1) / always true statement; 3.5 注釋標(biāo)簽 標(biāo)

10、簽用法作用<c>c>text</c> text 希望將其指示為代碼的文本。為您提供了一種將說明中的文本標(biāo)記為代碼的方法。使用 <code> 將多行指示為代碼<para><para>content</para>content段落文本。用于諸如 <remarks> 或 <returns> 等標(biāo)記內(nèi)，使您得以將結(jié)構(gòu)添加到文本中。<param><param name='name'>description</param>name 為方法參數(shù)名。將此名稱

11、用單引號括起來 (' ')。應(yīng)當(dāng)用于方法聲明的注釋中，以描述方法的一個參數(shù)。<paramref> <paramref name="name"/>name 要引用的參數(shù)名。將此名稱用雙引號括起來 (" ")。<paramref> 標(biāo)記為您提供了一種指示詞為參數(shù)的方法?？梢蕴幚?XML 文件，從而用某種獨(dú)特的方法格式化該參數(shù)。<see><see cref="member"/>cref = "member" 對可以通過當(dāng)前編譯環(huán)境進(jìn)行調(diào)用的成員或

12、字段的引用。編譯器檢查到給定代碼元素存在后，將 member 傳遞給輸出 XML 中的元素名。必須將 member 括在雙引號 (" ") 中。使您得以從文本內(nèi)指定鏈接。使用 <seealso> 指示希望在“請參閱”一節(jié)中出現(xiàn)的文本。<seealso><seealso cref="member"/>cref = "member" 對可以通過當(dāng)前編譯環(huán)境進(jìn)行調(diào)用的成員或字段的引用。編譯器檢查到給定代碼元素存在后，將 member 傳遞給輸出 XML 中的元素名。必須將 member 括在雙引號 (&q

13、uot; ") 中使您得以指定希望在“請參閱”一節(jié)中出現(xiàn)的文本。使用 <see> 從文本<example><example>description</example>description 代碼示例的說明。使用 <example> 標(biāo)記可以指定使用方法或其他庫成員的示例。一般情況下，這將涉及到 <code> 標(biāo)記的使用。<code><code>content</code>content 為希望將其標(biāo)記為代碼的文本。 記為您提供了一種將多行指示為代碼的方法。使用 <c>

14、; 指示應(yīng)將說明中的文本標(biāo)記為代碼<summary><summary>description</summary>此處description 為對象的摘要。應(yīng)當(dāng)用于描述類型成員。使用 <remarks> 以提供有關(guān)類型本身的信息。<exception><exception cref="member">description</exception>cref = "member" 對可從當(dāng)前編譯環(huán)境中獲取的異常的引用。編譯器檢查到給定異常存在后，將 member 轉(zhuǎn)換為輸出 X

15、ML 中的規(guī)范化元素名。必須將 member 括在雙引號 (" ") 中。description 說明。<exception> 標(biāo)記使您可以指定類能夠引發(fā)的異常。<include><include file='filename' path='tagpathname="id"' />filename 包含文檔的文件名。該文件名可用路徑加以限定。將 filename 括在單引號中 (' ')。 Tagpath：filename 中指向標(biāo)記名的標(biāo)記路徑。將此路徑括在單引號中 (

16、' ')。 name 注釋前邊的標(biāo)記中的名稱說明符；名稱具有一個 id。 id 位于注釋之前的標(biāo)記的 id。將此 id 括在雙引號中 (" ")。<include> 標(biāo)記使您得以引用描述源代碼中類型和成員的另一文件中的注釋。這是除了將文檔注釋直接置于源代碼文件中之外的另一種可選方法。<include> 標(biāo)記使用 XML XPath 語法。有關(guān)自定義 <include> 使用的方法，請參閱 XPath 文檔。<list> <list type="bullet" | "numbe

17、r" | "table"> <listheader> <term>term</term> <description>description</description> </listheader> <item> <term>term</term> <description>description</description> </item></list>term 定義的項(xiàng)，該項(xiàng)將在 text 中定義。 des

18、cription 目符號列表或編號列表中的項(xiàng)或者 term 的定義。<listheader> 塊用于定義表或定義列表中的標(biāo)題行。定義表時，只需為標(biāo)題中的項(xiàng)提供一個項(xiàng)。列表中的每一項(xiàng)用 <item> 塊指定。創(chuàng)建定義列表時，既需要指定 term 也需要指定 text。但是，對于表、項(xiàng)目符號列表或編號列表，只需為 text 提供一個項(xiàng)。列表或表所擁有的 <item> 塊數(shù)可以根據(jù)需要而定。<permission><permission cref="member">description</permission&g

19、t;cref = "member" 對可以通過當(dāng)前編譯環(huán)境進(jìn)行調(diào)用的成員或字段的引用。編譯器檢查到給定代碼元素存在后，將 member 轉(zhuǎn)換為輸出 XML 中的規(guī)范化元素名。必須將 member 括在雙引號 (" ") 中。 description 成員的訪問的說明。<permission> 標(biāo)記使您得以將成員的訪問記入文檔。System.Security.PermissionSet 使您得以指定對成員的訪問。<remarks><remarks>description</remarks>descriptio

20、n 成員的說明。<remarks> 標(biāo)記是可以指定有關(guān)類或其他類型的概述信息的位置。<summary> 是可以描述該類型的成員的位置。<returns> <returns>description</returns>description 返回值的說明。<returns> 標(biāo)記應(yīng)當(dāng)用于方法聲明的注釋，以描述返回值。<value> <value>property-description</value>property-description 屬性的說明。<value> 標(biāo)記使您得

21、以描述屬性。請注意，當(dāng)在 Visual Studio .NET 開發(fā)環(huán)境中通過代碼向?qū)砑訉傩詴r，它將會為新屬性添加 <summary> 標(biāo)記。然后，應(yīng)該手動添加 <value> 標(biāo)記以描述該屬性所表示的值。4 申明4.1 每行聲明數(shù)一行只建議作一個聲明，并按字母順序排列。如： int level; /推薦 int size; /推薦 int x, y; /不推薦4.2 初始化建議在變量聲明時就對其做初始化。4.3 位置變量建議置于塊的開始處，不要總是在第一次使用它們的地方做聲明。如： void MyMethod() int int1 = 0; / beginning

22、of method blockif (condition) int int2 = 0; / beginning of "if" block . 不過也有一個例外： for (int i = 0; i < maxLoops; i+) . 應(yīng)避免不同層次間的變量重名，如： int count; .void MyMethod() if (condition) int count = 0; / 避免 . .4.4 類和接口的聲明n 在方法名與其后的左括號間沒有任何空格。n 左花括號 “” 出現(xiàn)在聲明的下行并與之對齊，單獨(dú)成行。n 方法間用一個空行隔開。5 第五章命名規(guī)范5.1

23、 命名概述名稱應(yīng)該說明“什么”而不是“如何”。通過避免使用公開基礎(chǔ)實(shí)現(xiàn)（它們會發(fā)生改變）的名稱，可以保留簡化復(fù)雜性的抽象層。例如，可以使用 GetNextStudent()，而不是 GetNextArrayElement()。選擇正確名稱時的困難可能表明需要進(jìn)一步分析或定義項(xiàng)的目的。使名稱足夠長以便有一定的意義，并且足夠短以避免冗長。唯一名稱在編程上僅用于將各項(xiàng)區(qū)分開。表現(xiàn)力強(qiáng)的名稱是為了幫助人們閱讀；因此，提供人們可以理解的名稱是有意義的。其實(shí)從長變量名的負(fù)面作用三，因?yàn)镃trl+C和Ctrl+V加上在VS中的智能感知，其負(fù)面追用已經(jīng)很小。最優(yōu)秀的代碼它本身就是注釋。作為一流的程序員。并不僅

24、僅實(shí)現(xiàn)功能，而是要讓我們的代碼更加優(yōu)美，具備讓他人維護(hù)或今后擴(kuò)充的能力。作為現(xiàn)在的業(yè)務(wù)系統(tǒng)，其門檻的準(zhǔn)入水平已大大降低，實(shí)現(xiàn)功能上的需求已沒有什么難度，但是高手和菜鳥的區(qū)別在于，高手的代碼通俗易懂，在整個編碼的過程中，不僅能考慮到性能、還會考慮代碼可讀性和維護(hù)性。不過，請確保選擇的名稱符合適用語言的規(guī)則和標(biāo)準(zhǔn)。以下幾點(diǎn)是推薦的命名方法。n 避免容易被主觀解釋的難懂的名稱，如命名 AnalyzeThis()，或者屬性名 xxK8。這樣的名稱會導(dǎo)致多義性。n 在類屬性的名稱中包含類名是多余的，如 Book.BookTitle。而是應(yīng)該使用 Book.Title。n 只要合適，在變量名的末尾或開頭加

25、計算限定符（Avg、Sum、Min、Max、Index）。n 在變量名中使用互補(bǔ)對，如 min/max、begin/end 和 open/close。 n 布爾變量名應(yīng)該包含 Is，這意味著 Yes/No 或 True/False 值，如 fileIsFound。n 在命名狀態(tài)變量時，避免使用諸如 Flag 的術(shù)語。狀態(tài)變量不同于布爾變量的地方是它可以具有兩個以上的可能值。不是使用 documentFlag，而是使用更具描述性的名稱，如 documentFormatType。 （此項(xiàng)只供參考）n 即使對于可能僅出現(xiàn)在幾個代碼行中的生存期很短的變量，仍然使用有意義的名稱。僅對于短循環(huán)索引使用單字

26、母變量名，如 i 或 j。 可能的情況下，盡量不要使用原義數(shù)字或原義字符串，如 For i = 1 To 7。而是使用命名常數(shù)，如 For i = 1 To NUM_DAYS_IN_WEEK 以便于維護(hù)和理解。n 文件名要和類名相同，一般情況下一個類一個文件，文件名遵從Pascal命名法，無特殊情況，擴(kuò)展名小寫，使用統(tǒng)一而又通用的文件擴(kuò)展名： C# 類 .cs。5.2 大小寫規(guī)則下表匯總了大寫規(guī)則，并提供了不同類型的標(biāo)識符的示例。標(biāo)識符大小寫示例類PascalAppDomain枚舉類型PascalErrorLevel枚舉值PascalFatalError事件PascalValueChange異

27、常類PascalWebException 注意 總是以 Exception 后綴結(jié)尾。只讀的靜態(tài)字段PascalRedValue接口PascalIDisposable 注意 總是以 I 前綴開始。方法PascalToString命名空間PascalSystem.Drawing屬性PascalBackColor公共實(shí)例字段PascalRedValue 注意 很少使用。屬性優(yōu)于使用公共實(shí)例字段。受保護(hù)的實(shí)例字段Camel redValue 注意 很少使用。屬性優(yōu)于使用受保護(hù)的實(shí)例字段。私有的實(shí)例字段CamelredValue參數(shù)CameltypeName方法內(nèi)的變量CamelbackColor5.

28、3 縮寫為了避免混淆和保證跨語言交互操作，請遵循有關(guān)區(qū)縮寫的使用的下列規(guī)則： n 不要將縮寫或縮略形式用作標(biāo)識符名稱的組成部分。例如，使用 GetWindow，而不要使用 GetWin。 n 不要使用計算機(jī)領(lǐng)域中未被普遍接受的縮寫。 n 在適當(dāng)?shù)臅r候，使用眾所周知的縮寫替換冗長的詞組名稱。例如，用 UI 作為 User Interface 縮寫，用 OLAP 作為 On-line Analytical Processing 的縮寫。 n 在使用縮寫時，對于超過兩個字符長度的縮寫請使用 Pascal 大小寫或 Camel 大小寫。例如，使用 HtmlButton 或 HTMLButton。但是，

29、應(yīng)當(dāng)大寫僅有兩個字符的縮寫，如，System.IO，而不是 System.Io。5.4 命名空間n 命名命名空間時的一般性規(guī)則是使用公司名稱，后跟技術(shù)名稱和可選的功能與設(shè)計，如下所示: CompanyName.TechnologyName.Feature.Designn 命名空間使用Pascal大小寫，用逗號分隔開。n TechnologyName 指的是該項(xiàng)目的英文縮寫，或軟件名。n 命名空間和類不能使用同樣的名字。例如，有一個類被命名為Debug后，就不要再使用Debug作為一個名稱空間名。 5.5 類n 使用 Pascal 大小寫。n 用名詞或名詞短語命名類。n 使用全稱避免縮寫，除非縮

30、寫已是一種公認(rèn)的約定，如URL、HTMLn 不要使用類型前綴，如在類名稱上對類使用 C 前綴。例如，使用類名稱 FileStream，而不是 CFileStream。 n 不要使用下劃線字符 (_)。 n 有時候需要提供以字母 I 開始的類名稱，雖然該類不是接口。只要 I 是作為類名稱組成部分的整個單詞的第一個字母，這便是適當(dāng)?shù)?。例如，類名稱 IdentityStore 是適當(dāng)?shù)?。在適當(dāng)?shù)牡胤剑褂脧?fù)合單詞命名派生的類。派生類名稱的第二個部分應(yīng)當(dāng)是基類的名稱。例如，ApplicationException 對于從名為 Exception 的類派生的類是適當(dāng)?shù)拿Q，原因ApplicationEx

31、ception 是一種Exception。請在應(yīng)用該規(guī)則時進(jìn)行合理的判斷。例如，Button 對于從 Control 派生的類是適當(dāng)?shù)拿Q。盡管按鈕是一種控件，但是將 Control 作為類名稱的一部分將使名稱不必要地加長。 public class FileStream public class Buttonpublic class String 5.6 接口以下規(guī)則概述接口的命名指南： n 用名詞或名詞短語，或者描述行為的形容詞命名接口。例如，接口名稱 IComponent 使用描述性名詞。接口名稱 ICustomAttributeProvider 使用名詞短語。名稱 IPersistab

32、le 使用形容詞。 n 使用 Pascal 大小寫。 n 少用縮寫。 n 給接口名稱加上字母 I 前綴，以指示該類型為接口。在定義類/接口對（其中類是接口的標(biāo)準(zhǔn)實(shí)現(xiàn)）時使用相似的名稱。兩個名稱的區(qū)別應(yīng)該只是接口名稱上有字母 I 前綴。 n 不要使用下劃線字符 (_)。 n 當(dāng)類是接口的標(biāo)準(zhǔn)執(zhí)行時，定義這一對類/接口組合就要使用相似的名稱。兩個名稱的不同之處只是接口名前有一個I前綴。以下是正確命名的接口的示例。 public interface IServiceProvider public interface IFormatable以下代碼示例闡釋如何定義 IComponent 接口及其標(biāo)準(zhǔn)實(shí)

33、現(xiàn) Component 類。 public interface IComponent / Implementation code goes here. public class Component: IComponent / Implementation code goes here.5.7 屬性 (Attribute)應(yīng)該總是將后綴 Attribute 添加到自定義屬性類。以下是正確命名的屬性類的示例。 public class ObsoleteAttribute 5.8 枚舉 (Enum)枚舉 (Enum) 值類型從 Enum 類繼承。以下規(guī)則概述枚舉的命名指南： n 對于 Enum 類型

34、和值名稱使用 Pascal 大小寫。 n 少用縮寫。 n 不要在 Enum 類型名稱上使用 Enum 后綴。 n 避免顯式指定枚舉的值/正確  public enum Color      Red,Green,Blue     /避免   public enum Color      Red=1,Green=2,Blue=3   n 避免為枚舉指定一個類型/避免  p

35、ublic enum Color:long      Red,Green,Blue   5.9 參數(shù)以下規(guī)則概述參數(shù)的命名指南： n 使用描述性參數(shù)名稱。參數(shù)名稱應(yīng)當(dāng)具有足夠的描述性，以便參數(shù)的名稱及其類型可用于在大多數(shù)情況下確定它的含義。 n 對參數(shù)名稱使用 Camel 大小寫。 n 使用描述參數(shù)的含義的名稱，而不要使用描述參數(shù)的類型的名稱。開發(fā)工具將提供有關(guān)參數(shù)的類型的有意義的信息。因此， 通過描述意義，可以更好地使用參數(shù)的名稱。少用基于類型的參數(shù)名稱，僅在適合使用它們的地方使用它們。n 不要給參數(shù)名稱加匈牙利

36、語類型表示法的前綴。 以下是正確命名的參數(shù)的示例。 Type GetType(string typeName)string Format(string format, args() As object)5.10 方法以下規(guī)則概述方法的命名指南： n 使用動詞或動詞短語命名方法。 n 使用 Pascal 大小寫。 n 以下是正確命名的方法的實(shí)例。 RemoveAll() GetCharArray() Invoke()5.11 屬性 (property)以下規(guī)則概述屬性的命名指南： n 使用名詞或名詞短語命名屬性。 n 使用 Pascal 大小寫。 n 不要使用匈牙利語表示法。 n 考慮用與屬性的

37、基礎(chǔ)類型相同的名稱創(chuàng)建屬性。例如，如果聲明名為 Color 的屬性，則屬性的類型同樣應(yīng)該是 Color。請參閱本主題中后面的示例。 以下代碼示例闡釋正確的屬性命名。 public class SampleClass public Color BackColor / Code for Get and Set accessors goes here. 5.12 事件以下規(guī)則概述事件的命名指南： n 對事件處理程序名稱使用 EventHandler 后綴。 n 指定兩個名為 sender 和 e 的參數(shù)。sender 參數(shù)表示引發(fā)事件的對象。sender 參數(shù)始終是object 類型的，即使在可以使

38、用更為特定的類型時也如此。與事件相關(guān)聯(lián)的狀態(tài)封裝在名為 e 的事件類的實(shí)例中。對 e 參數(shù)類型使用適當(dāng)而特定的事件類。 n 用 EventArgs 后綴命名事件參數(shù)類。 n 考慮用動詞命名事件。 n 使用動名詞（動詞的“ing”形式）創(chuàng)建表示事件前的概念的事件名稱，用過去式表示事件后。例如，可以取消的 Close 事件應(yīng)當(dāng)具有 Closing 事件和 Closed 事件。不要使用BeforeXxx/AfterXxx 命名模式。 n 不要在類型的事件聲明上使用前綴或者后綴。例如，使用 Close，而不要使用 OnClose。 n 通常情況下，對于可以在派生類中重寫的事件，應(yīng)在類型上提供一個受保護(hù)

39、的方法（稱為 OnXxx）。此方法只應(yīng)具有事件參數(shù) e，因?yàn)榘l(fā)送方總是類型的實(shí)例。 以下示例闡釋具有適當(dāng)名稱和參數(shù)的事件處理程序。 public delegate void MouseEventHandler(object sender, MouseEventArgs e);以下示例闡釋正確命名的事件參數(shù)類。 public class MouseEventArgs : EventArgs int x; int y; public MouseEventArgs(int x, int y) this.x = x;this.y = y; public int X get return x; publ

40、ic int Y get return y; 5.13 常量 (const)使用Pascal命名 5.14 字段以下規(guī)則概述字段的命名指南： n private、protected 使用 Camel 大小寫。n public 使用 Pascal 大小寫。n 拼寫出字段名稱中使用的所有單詞。僅在開發(fā)人員一般都能理解時使用縮寫。字段名稱不要使用大寫字母。下面是正確命名的字段的示例。 class SampleClass string url; string destinationUrl;n 不要對字段名使用匈牙利語表示法。好的名稱描述語義，而非類型。 n 不要對字段名或靜態(tài)字段名應(yīng)用前綴。具體說來，

41、不要對字段名稱應(yīng)用前綴來區(qū)分靜態(tài)和非靜態(tài)字段。例如，應(yīng)用 g_ 或 s_ 前綴是不正確的。 5.15 靜態(tài)字段以下規(guī)則概述靜態(tài)字段的命名指南： n 使用名詞、名詞短語或者名詞的縮寫命名靜態(tài)字段。 n 使用 Pascal 大小寫。 n 對靜態(tài)字段名稱使用匈牙利語表示法前綴。 n 建議盡可能使用靜態(tài)屬性而不是公共靜態(tài)字段。 5.16 集合集合是一組組合在一起的類似的類型化對象，如哈希表、查詢、堆棧、字典和列表，集合的命名建議用復(fù)數(shù)。5.17 范型如果你對類型參數(shù)沒有其他的跟上下文有關(guān)的信息（additional contextual information），你應(yīng)該使用字母T。

42、packagevar      6 第六章語句6.1 每行一個語句每行最多包含一個語句。如 a+; /推薦 b-; /推薦 a+; b-; /不推薦6.2 復(fù)合語句復(fù)合語句是指包含"父語句子語句;子語句;"的語句，使用復(fù)合語句應(yīng)遵循以下幾點(diǎn)：n 子語句要縮進(jìn)。n 左花括號“” 在復(fù)合語句父語句的下一行并與之對齊，單獨(dú)成行。n 即使只有一條子語句也不要省略花括號“ ”。 如 while (d + = s+) n+; 6.3 return 語句return語句中不使用括號，除非它能使返回值更加清晰。如： return;

43、 return myDisk.size(); return (size ? size : defaultSize)7 控件命名規(guī)則7.1 命名方法控件名簡寫+英文描述，英文描述首字母大寫。7.2 主要控件名簡寫對照表控件名簡寫控件名簡寫LabellblTextBoxtxtButtonbtnLinkButtonlnkbtnImageButtonimgbtnDropDownListddlListBoxlstDataGriddgDataListdlCheckBoxchkCheckBoxListchklsRadioButtonrdoRadioButtonListrdoltImageimgPanelpn

44、lCalendercldAdRotatorarTabletblRequiredFieldValidatorrfvCompareValidatorcvRangeValidatorrvRegularExpressionValidatorrevValidatorSummaryvsCrystalReportViewerrptvew8 程序結(jié)構(gòu)8.1 程序結(jié)構(gòu)規(guī)范n 程序結(jié)構(gòu)清晰，簡單易懂，單個函數(shù)的程序行數(shù)不得超過100行。避免使用大文件。如果一個文件里的代碼超過300400行，必須考慮將代碼分開到不同類中。 避免寫太長的方法。一個典型的方法代碼在125行之間。如果一個方法發(fā)代碼超過25行，應(yīng)該考慮將

45、其分解為不同的方法。一個文件應(yīng)避免超過2000行。n 打算干什么，要簡單，直截了當(dāng)，代碼精簡，避免垃圾程序。n 盡量使用.NET庫函數(shù)和公共函數(shù)(無特殊情況不要使用外部方法調(diào)用windows的核心動態(tài)鏈接庫API)。n 不要隨意定義全局變量，盡量使用局部變量。n 方法名需能看出它作什么。別使用會引起誤解的名字。如果名字一目了然，就無需用文檔來解釋方法的功能了。好： void SavePhoneNumber ( string phoneNumber )       / 

46、;Save the phone number. 不好： / This method will save the phone number. void SaveData ( string phoneNumber )       / Save the phone number. n 程序編碼力求簡潔，結(jié)構(gòu)清晰，避

47、免太多的分支結(jié)構(gòu)及太過于技巧性的程序。n 避免采用過于復(fù)雜的條件測試，避免過多的循環(huán)嵌套和條件嵌套。 n 盡量使用.NET庫函數(shù)和公共函數(shù)(無特殊情況不要使用外部方法調(diào)用windows的核心動態(tài)鏈接庫API)。n 不要隨意定義全局變量，聲明局部變量，并傳遞給方法。不要在方法間共享成員變量。如果在幾個方法間共享一個成員變量，那就很難知道是哪個方法在什么時候修改了它的值。 n 別在程序中使用固定數(shù)值，用常量代替。8.2 結(jié)構(gòu)書寫規(guī)范n 把所有系統(tǒng)框架提供的名稱空間組織到一起，把第三方提供的名稱空間放到系統(tǒng)名稱空間的下面using System;   using

48、0;System.Collection.Generic;   using System.ComponentModel;   using System.Data;  using MyCompany;  using MyControls;n 所有的類成員變量應(yīng)該被聲明在類的頂部，并用一個空行把它們和方法以及屬性的聲明區(qū)分開public class MyClass          int m_Numb

49、er;   string m_Name;   public void SomeMethod1();   public void SomeMethod2();   n 避免采用多賦值語句，如x = y = z;。 n 必要時使用enum 。別用數(shù)字或字符串來指示離散值。 好： enum MailType  void SendMail (string message, MailType ma

50、ilType)       switch ( mailType )                 case MailType.Html:            / Do some

51、thing            break;          case MailType.PlainText:            / Do something     &#

52、160;      break;           case MailType.Attachment:            / Do something          &#

53、160; break;           default:            / Do something            break;      

54、不好： void SendMail (string message, string mailType)       switch ( mailType )                 case "Html":   &

55、#160;        / Do something            break;           case "PlainText":        

56、;    / Do something            break;           case "Attachment":            &#

57、160;/ Do something            break;           default:            / Do something    

58、        break;       n 一個方法只完成一個任務(wù)。不要把多個任務(wù)組合到一個方法中，即使那些任務(wù)非常小。好： void SaveAddress ( string address ) / Save the address. / . void SendEmail ( string address, string email ) / Send an email to inform the supervisor that the add

59、ress is changed. / . 不好： void SaveAddress ( string address, string email ) / Job 1. / Save the address. / . / Job 2. / Send an email to inform the supervisor that the address is changed. / . n 使用括號清晰地表達(dá)算術(shù)表達(dá)式和邏輯表達(dá)式的運(yùn)算順序。如將 x=a*b/c*d 寫成 x=(a*b/c)*d可避免閱讀者誤解為x=(a*b)/(c*d)。 n 總是使用以零為基數(shù)的數(shù)組。n 把引用的系統(tǒng)的namesp

60、ace和自定義或第三方的用一個換行把它們分開.n 目錄結(jié)構(gòu)中要反應(yīng)出namespace的層次.9 異常處理9.1 異常處理n 不要“捕捉了異常卻什么也不做”。如果隱藏了一個異常，你將永遠(yuǎn)不知道異常到底發(fā)生了沒有。n 發(fā)生異常時，給出友好的消息給用戶，但要精確記錄錯誤的所有可能細(xì)節(jié)，包括發(fā)生的時間，和相關(guān)方法，類名等。 n 不必每個方法都用try-catch。當(dāng)特定的異?？赡馨l(fā)生時才使用。比如，當(dāng)你寫文件時，處理異常FileIOException. n 別寫太大的 try-catch 模塊。如果需要，為每個執(zhí)行的任務(wù)編寫單獨(dú)的 try-catch 模塊。 這將幫你找出哪一段代碼產(chǎn)生異常，并給用戶

61、發(fā)出特定的錯誤消息。n 只捕捉特定的異常，而不是一般的異常。好： void ReadFromFile ( string fileName )       try                 / read from file.    &#

62、160;       catch (FileIOException ex)                 / log error.           /  re-throw exception dependi