【正文】 名字，如value和item，而不是重復(fù)類型的名字—如果除了類型之外，標(biāo)志符沒有其它的語(yǔ)義，而且參數(shù)的類型不重要。 要使用CLR的通用類型名，而不要使用語(yǔ)言特有的別名如果除了類型之外，標(biāo)志符沒有其它的語(yǔ)義。 避免使用語(yǔ)言特有的名字 要給類型名使用語(yǔ)義上的有意義的名字，而不要使用語(yǔ)言特有的關(guān)鍵字。例如：要用GetWindow，而不要用GetWin。 不要使用縮寫詞和縮約詞作為標(biāo)志符名稱的一部分。 不要在控件和變量的范圍外使用匈牙利命名法。 不要使用下劃線、連詞符以及其它任何既非字母也非數(shù)字的字符。 要為標(biāo)志符選擇易于閱讀的名字如：一個(gè)名為HorizontalAlignment的屬性就比AlignmentHorizontal更易于閱讀。為此，名字的意思清楚比長(zhǎng)度更重要。若要確定某個(gè)單詞是否是緊湊格式的復(fù)合詞，請(qǐng)查閱最新的詞典。例如，hashtable 是一個(gè)緊湊格式的復(fù)合詞，應(yīng)將其視為一個(gè)單詞并相應(yīng)地確定大小寫。 復(fù)合詞和常用術(shù)語(yǔ)的大小寫規(guī)則 不要將所謂的緊湊格式復(fù)合詞中的每個(gè)單詞都大寫。例如，名為 xmlStream 的參數(shù)是一個(gè)采用大小寫混合格式的標(biāo)識(shí)符，它使用長(zhǎng)型首字母縮寫詞 (xml) 作為首個(gè)單詞。又如，名為 htmlReader 的參數(shù)是一個(gè)采用大小寫混合格式的標(biāo)識(shí)符，它使用長(zhǎng)型首字母縮寫詞作為首個(gè)單詞。 包含三個(gè)或三個(gè)以上字符的首字母縮寫詞只有第一個(gè)字符大寫，但當(dāng)作為camel格式的標(biāo)識(shí)符的首個(gè)單詞時(shí)全部小寫。例如，名為 DBRate 的屬性是一個(gè)采用 Pascal 大小寫格式的標(biāo)識(shí)符，它使用短型首字母縮寫詞 (DB) 作為首個(gè)單詞。標(biāo)識(shí)符大小寫規(guī)則優(yōu)先于首字母縮寫詞大小寫規(guī)則。包含三個(gè)或三個(gè)以上字符的首字母縮寫詞為長(zhǎng)型首字母縮寫詞。所有首字母縮寫詞應(yīng)至少包含兩個(gè)字符。如果在采用大小寫混合格式的標(biāo)識(shí)符中將這兩個(gè)縮寫詞用作首個(gè)單詞，則它們的大小寫形式應(yīng)分別為 id 和 ok。 注意：可在標(biāo)識(shí)符中使用的兩個(gè)縮寫詞是 ID 和 OK。例如，ID 是 identifier 的縮寫。只有在公眾廣為認(rèn)知和理解的情況下，才應(yīng)在標(biāo)識(shí)符中使用首字母縮寫詞。 首字母縮寫詞的大小寫規(guī)則首字母縮寫詞是由術(shù)語(yǔ)或短語(yǔ)中各單詞的首字母構(gòu)成的單詞。函數(shù)中的局部變量則可采用Camel或匈牙利方式?？丶谩癬匈牙利”前綴方式。私有字段采用“_camel”大小寫混合，以區(qū)別參數(shù)和緩存參數(shù)的私有字段。對(duì)于由多個(gè)單詞組成的所有公共成員、類型及命名空間名稱，要使用 Pascal 大小寫。 標(biāo)志符大小寫方式示例類 Pascal AppDomain 枚舉類型 Pascal ErrorLevel 枚舉值 Pascal FatalError 事件 Pascal ValueChanged 異常類 Pascal WebException 只讀的靜態(tài)字段 Pascal RedValue 接口 IPascal IDisposable 方法 Pascal ToString 命名空間 Pascal 參數(shù) camel typeName 屬性 Pascal BackColor 中間層方法接口IPascalILogin私有字段_camel_userName控件命名_匈牙利_txtUserName局部變量camel / 匈牙利textLength / iLength如果標(biāo)識(shí)符由多個(gè)單詞組成，請(qǐng)不要在各單詞之間使用分隔符，如下劃線（“_”）或連字符（“”）等。例如：backColor SCREAMING_CAPS標(biāo)識(shí)符中的所有字母都大寫?？梢詫?duì)三字符或更多字符的標(biāo)識(shí)符使用 Pascal 大小寫。 大小寫約定 大小寫樣式下列術(shù)語(yǔ)描述了標(biāo)識(shí)符的不同大小寫形式。 為了提供一致的開發(fā)人員體驗(yàn)，公共公開的元素（如公共類和受保護(hù)的方法）必須遵守這些準(zhǔn)則。1 命名規(guī)范對(duì)于組成類庫(kù)的元素（包括程序集、命名空間、類型、成員和參數(shù)），命名準(zhǔn)則提供如何為這些元素選擇合適的標(biāo)識(shí)符的準(zhǔn)則。在特殊情況下，要實(shí)現(xiàn)好的庫(kù)設(shè)計(jì)，可能會(huì)需要違反這些設(shè)計(jì)準(zhǔn)則。不一致的庫(kù)設(shè)計(jì)會(huì)對(duì)開發(fā)人員的工作效率造成不良影響并妨礙他們互相吸納。.NET Framework 設(shè)計(jì)準(zhǔn)則的目標(biāo)旨在通過提供一種獨(dú)立于開發(fā)所用編程語(yǔ)言的統(tǒng)一編程模型，幫助庫(kù)設(shè)計(jì)人員確保其用戶獲得 API 的一致性及易用性的好處。類庫(kù)開發(fā)的設(shè)計(jì)準(zhǔn)則結(jié)構(gòu)設(shè)計(jì)本規(guī)范以《.NET Framework 開發(fā)人員指南類庫(kù)開發(fā)的設(shè)計(jì)準(zhǔn)則》為基礎(chǔ)，吸收、整理、補(bǔ)充而成。類庫(kù)開發(fā)的設(shè)計(jì)準(zhǔn)則適用于擴(kuò)展 .NET Framework 并與其交互的庫(kù)開發(fā)。在開發(fā)擴(kuò)展 .NET Framework 的類和組件時(shí)，強(qiáng)烈建議您遵循這些設(shè)計(jì)準(zhǔn)則。 這些準(zhǔn)則用于幫助類庫(kù)設(shè)計(jì)人員理解如何在不同解決方案之間進(jìn)行權(quán)衡。這類情況應(yīng)該很少見，所以您必須有充分的理由才能作出這種“違反”決定。選擇符合這些準(zhǔn)則的標(biāo)識(shí)符可以提高您的庫(kù)的可用性，并使用戶相信您的庫(kù)將不需要學(xué)習(xí)一組新的規(guī)則。然而，為在整個(gè)代碼中保持一致性以及改進(jìn)可維護(hù)性，應(yīng)考慮在整個(gè)代碼中始終使用這些約定。 PascalCasing將標(biāo)識(shí)符的首字母和后面連接的每個(gè)單詞的首字母都大寫。例如：BackColor camelCasing標(biāo)識(shí)符的首字母小寫，而每個(gè)后面連接的單詞的首字母都大寫。例如：IO 匈牙利標(biāo)識(shí)符加上類型前綴，例如：string strUserName 標(biāo)識(shí)符的大小寫規(guī)則下列準(zhǔn)則是用于標(biāo)識(shí)符的通用規(guī)則。而應(yīng)使用大小寫來(lái)指示每個(gè)單詞的開頭。 對(duì)參數(shù)名稱使用camel大小寫混合。對(duì)于Class，應(yīng)避免使用公共字段（const除外），因?yàn)镃在數(shù)據(jù)成員和屬性之間做改變會(huì)打破二進(jìn)制兼容性。來(lái)區(qū)分控件和普通變量。若局部變量是控件形式則采用匈牙利方式。例如，HTML 是 Hypertext Markup Language 的首字母縮寫。首字母縮寫詞不同于縮寫詞，因?yàn)榭s寫詞是一個(gè)單詞的縮寫。通常情況下，庫(kù)名不應(yīng)使用縮寫詞。在采用 Pascal 大小寫格式的標(biāo)識(shí)符中，這兩個(gè)縮寫詞的大小寫形式應(yīng)分別為 Id 和 Ok。首字母縮寫詞的大小寫取決于首字母縮寫詞的長(zhǎng)度。為了便于這些準(zhǔn)則的實(shí)施，如果某一首字母縮寫詞恰好包含兩個(gè)字符，則將其視為短型首字母縮寫詞。下列準(zhǔn)則為短型和長(zhǎng)型首字母縮寫詞指定了正確的大小寫規(guī)則。 兩字符首字母縮寫詞的兩個(gè)字符都要大寫，但當(dāng)作為camel格式的標(biāo)識(shí)符的首個(gè)單詞時(shí)全部小寫。又如，名為 ioChannel 的參數(shù)是一個(gè)采用大小寫混合格式的標(biāo)識(shí)符，它使用短型首字母縮寫詞 (IO) 作為首個(gè)單詞。例如，名為 XmlWriter 的類是一個(gè)采用 Pascal 大小寫格式的標(biāo)識(shí)符，它使用長(zhǎng)型首字母縮寫詞作為首個(gè)單詞。 如果任何首字母縮寫詞位于采用camel格式的標(biāo)識(shí)符開頭，則無(wú)論該首字母縮寫詞的長(zhǎng)度如何，都不大寫其中的任何字符。又如，名為 dbServerName 的參數(shù)是一個(gè)采用大小寫混合格式的標(biāo)識(shí)符，它使用短型首字母縮寫詞 (db) 作為首個(gè)單詞。這種復(fù)合詞是指寫作一個(gè)單詞的復(fù)合詞，如“Endpoint”。如果采用 Pascal 大小寫格式，則該復(fù)合詞為 Hashtable；如果采用大小寫混合格式，則該復(fù)合詞為 hashtable。常用復(fù)合詞和常用術(shù)語(yǔ)的大小寫及拼寫Pascalcamel錯(cuò)誤寫法BitFlagbitFlagBitflagCallbackcallbackCallBackCanceledcanceledCancelledDoNotdoNotDontEmailEMailEndpointendpointEndPointFileNamefileNameFilenameGridlinegridlineGridLineHashtablehashtableHashTableIdidIDIndexesindexesIndicesLogOfflogOffLogOutLogOnlogOnLogInNamespacenamespaceNameSpaceOkokOKPipiPISignInsignInSignOnSignOutsingOutsignOffUseNameuseNameUsenameWhiteSpacewhiteSpaceWhitespaceWritablewritableWriteable在VSTS2008的靜態(tài)代碼分析中，設(shè)置數(shù)據(jù)保存在文件 %FxCopHome%\ 通用命名約定 單詞的選擇標(biāo)志符的名字應(yīng)該清楚地說明每個(gè)成員做什么，以及每個(gè)類型和參數(shù)表示什么。名字應(yīng)該與場(chǎng)景、系統(tǒng)的邏輯組成或物理組成以及為人熟知的概念相對(duì)應(yīng)，而不應(yīng)該與技術(shù)或架構(gòu)相對(duì)應(yīng)。 要更看重可讀性，而不是更看重簡(jiǎn)短性如：CanScrollHorizontally要?jiǎng)龠^ScrollableX。下劃線作為私有字段的前綴是個(gè)例外。 使用單詞縮寫和首字母縮寫詞 避免使用與廣泛使用的編程語(yǔ)言的關(guān)鍵字有沖突的標(biāo)志符。縮約詞，如：won’t是will not 的縮約詞。 不要使用未被廣泛接受的首字母縮寫詞，即使被廣泛接受的首字母縮寫詞，也只應(yīng)在必需的時(shí)候才使用。如：GetLength比GetInt要好。例如：，而不是ToLong（Long是C中的別名）下表顯示了內(nèi)置 C 類型的關(guān)鍵字，這些類型是 System 命名空間中的預(yù)定義類型的別名。如：Compare(object obj)改為Compare(object target) 匈牙利前綴定義 常用控件字段/變量命名前綴組件類型前綴例子ButtonbtnbtnCloseC1DockingTabtabtabDetailC1DockingTabPagepagpagPriceCheckBoxchkchkReadOnlyCheckedListBox(ListBox)lstlstDepartmentComboBoxcbocboEnglishDataGridViewgrdDataSetdsDateTimePickerdtpdtpPublishFlowLayoutPanelflpGroupBoxgrpImageListilsLabel(LinkLabel)lbllblNameLinkLabel(Label)lblListBox(CheckedListBox)lstlstPolicyCodesListViewlvwlvwHeadingsMaskedTextBox(TextBox)txtMonthCalendarcalNotifyIconnicoNumericUpDownntp(Numeric TimePicker)PanelpnlPictureBoxpicProgressBarprgRadioButtonopt(Option button)RichTextBoxrtxtSplitContainersptTabControl(C1DockingTab)tabTableLayoutPaneltlpTextBox(MaskedTextBox)txttxtNameToolTiptipTreeViewtvwWebBrowserwbrCAB中WorkSpacespc 菜單和工具欄控件字段/變量命名前綴控件類型前綴例子ContextMenuStripmnuMenuStripmnuStatusStripstaToolStriptlsToolStripContainertlcToolStripButtonbtnToolStripLabellblToolStripSeparatorsepToolStripControlHosthstToolStripComboBoxcboToolStripTextBoxtxtToolStripMenuItemmnuToolStripSplitButtonsptToolStripDropDownButtondrpToolStripStatusLabellbl 常用變量的前綴(簡(jiǎn)單變量不建議采用此種方式)C類型前綴例子bool b/blnbyte c/bytsbyte cchar cdecimal ddouble dfloat fint iuint uilong lulong ulobject oshort nushort unstring sz/str 程序集和命名空間的命名 通用約定 要用公司名稱作為命名空間的前綴，這樣就可避免與另一家公司使用相同的名字。 考慮在適當(dāng)?shù)臅r(shí)候在命名空間中使用復(fù)數(shù)。 命名空間與類型名的沖突 推薦的命名規(guī)則下表為常用程序集和命名空間的命名規(guī)則。