C# 代碼大小寫規范

C# 一般采用帕斯卡命名和駝峰命名，.NET類庫就是使用這種命名方法， 可見是微軟推薦的

• PasalCasing：標識符的第一個單詞的字母大寫；
• camelCasing：標識符的第一個單詞的字母小寫。

下表描述了不同類型標識符的大小寫規則

這三個標紅的是采用駝峰（Camel）命名法

其余的是帕斯卡（pascal）命名法

C#中的大小寫約定

許多命名約定都與標識符的大小寫有關。值得注意的是，公共語言運行庫 (CLR) 支持區分大小寫和不區分大小寫的語言。本主題中描述的大小寫約定可幫助開發人員理解和使用庫。

大小寫樣式

下列術語描述了標識符的不同大小寫形式。

Pascal 大小寫

將標識符的首字母和后面連接的每個單詞的首字母都大寫。可以對三字符或更多字符的標識符使用 Pascal 大小寫。

例如： BackColor

大小寫混合

標識符的首字母小寫，而每個后面連接的單詞的首字母都大寫。

例如： backColor

大寫

標識符中的所有字母都大寫。

例如： IO

標識符的大小寫規則

如果標識符由多個單詞組成，請不要在各單詞之間使用分隔符，如下劃線（“_”）或連字符（“-”）等。而應使用大小寫來指示每個單詞的開頭。

下列準則是用于標識符的通用規則。

對于由多個單詞組成的所有公共成員、類型及命名空間名稱，要使用 Pascal 大小寫。

注意，這條規則不適用于實例字段。由于成員設計準則中詳細說明的原因，不應使用公共實例字段。

對參數名稱使用大小寫混合。

下表匯總了標識符的大小寫規則，并提供了不同類型標識符的示例。

首字母縮寫的大小寫規則

首字母縮寫詞是由術語或短語中各單詞的首字母構成的單詞。例如，HTML 是 Hypertext Markup Language 的首字母縮寫。只有在公眾廣為認知和理解的情況下，才應在標識符中使用首字母縮寫詞。首字母縮寫詞不同于縮寫詞，因為縮寫詞是一個單詞的縮寫。例如，ID 是 identifier 的縮寫。通常情況下，庫名不應使用縮寫詞。

可在標識符中使用的兩個縮寫詞是 ID 和 OK。在采用 Pascal 大小寫格式的標識符中，這兩個縮寫詞的大小寫形式應分別為 Id 和 Ok。如果在采用大小寫混合格式的標識符中將這兩個縮寫詞用作首個單詞，則它們的大小寫形式應分別為 id 和 ok。

首字母縮寫詞的大小寫取決于首字母縮寫詞的長度。所有首字母縮寫詞應至少包含兩個字符。為了便于這些準則的實施，如果某一首字母縮寫詞恰好包含兩個字符，則將其視為短型首字母縮寫詞。包含三個或三個以上字符的首字母縮寫詞為長型首字母縮寫詞。 下列準則為短型和長型首字母縮寫詞指定了正確的大小寫規則。標識符大小寫規則優先于首字母縮寫詞大小寫規則。

兩字符首字母縮寫詞的兩個字符都要大寫，但當首字母縮寫詞作為大小寫混合格式的標識符的首個單詞時例外。

例如，名為 DBRate 的屬性是一個采用 Pascal 大小寫格式的標識符，它使用短型首字母縮寫詞 (DB) 作為首個單詞。又如，名為 ioChannel 的參數是一個采用大小寫混合格式的標識符，它使用短型首字母縮寫詞 (IO) 作為首個單詞。

包含三個或三個以上字符的首字母縮寫詞只有第一個字符大寫，但當首字母縮寫詞作為大小寫混合格式的標識符的首個單詞時例外。

例如，名為 XmlWriter 的類是一個采用 Pascal 大小寫格式的標識符，它使用長型首字母縮寫詞作為首個單詞。又如，名為 htmlReader 的參數是一個采用大小寫混合格式的標識符，它使用長型首字母縮寫詞作為首個單詞。

如果任何首字母縮寫詞位于采用大小寫混合格式的標識符開頭，則無論該首字母縮寫詞的長度如何，都不大寫其中的任何字符。

例如，名為 xmlStream 的參數是一個采用大小寫混合格式的標識符，它使用長型首字母縮寫詞 (xml) 作為首個單詞。又如，名為 dbServerName 的參數是一個采用大小寫混合格式的標識符，它使用短型首字母縮寫詞 (db) 作為首個單詞。

復合詞和常用術語的大小寫規則

不要將所謂的緊湊格式復合詞中的每個單詞都大寫。這種復合詞是指寫作一個單詞的復合詞，如“endpoint”。

例如，hashtable 是一個緊湊格式的復合詞，應將其視為一個單詞并相應地確定大小寫。如果采用 Pascal 大小寫格式，則該復合詞為 Hashtable；如果采用大小寫混合格式，則該復合詞為 hashtable。若要確定某個單詞是否是緊湊格式的復合詞，請查閱最新的詞典。

下表列出了不是緊湊格式復合詞的一些常用術語。術語先以 Pascal 大小寫格式顯示，后面的括號中的是其大小寫混合格式。

• BitFlag (bitFlag)
• FileName (fileName)
• LogOff (logOff)
• LogOn (logOn)
• SignIn (signIn)
• SignOut (signOut)
• UserName (userName)
• WhiteSpace (whiteSpace)

區分大小寫

大小寫準則只是為了使標識符更易于閱讀和辨認。不能將大小寫規則用作避免庫元素之間的命名沖突的手段。 不要假定所有編程語言都區分大小寫。事實并非如此。不能僅憑大小寫區分名稱。