.net代码规范.docxVIP

.NET设计规范命名规范大小写约定PascalCasing将标识符的首字母和后面连接的每个单词的首字母都大写。可以对三字符或更多字符的标识符使用 Pascal 大小写。例如：BackColor camelCasing标识符的首字母小写，而每个后面连接的单词的首字母都大写。例如：backColor对于由多个单词组成的所有公共成员、类型及命名空间名称，要使用 Pascal 大小写。对参数名称使用大小写混合。下表汇总了标识符的大小写规则，并提供了不同类型标识符的示例。表不同类型的标识符的大小写规则标识符大小写方式示例类PascalAppDomain 枚举类型PascalErrorLevel 枚举值PascalFatalError 事件PascalValueChanged 异常类PascalWebException 只读的静态字段PascalRedValue 接口PascalIDisposable 方法PascalToString 命名空间PascalSystem.Drawing 参数CameltypeName 属性PascalBackColor 首字母缩写词与单词缩写首字母缩写词是由一个短语的首字母组成的，而单词缩写则仅仅把一个单词的长度变短。要把两个字母的首字母缩写词全部大写，除非他是camelCasing风格的参数名的第一个单词。System.IOpublic void StartIO(Stream ioStream)要把由三个或三个以上字母组成的首字母缩写词的第一个字母大写。只有第一个字母大写，除非首字母缩写词是camelCasing风格的标识符的第一个单词。System.Xmlpublic void ProcessHtmlTag(string htmlTag)在涉及大小写时，大多数复合词术语要作为单个单词处理。不要把所谓闭合形式的复合词中每个单词的首字母大写。下表列出一些常用的复合词和常用术语的大小写。表常用的复合词和常用术语的大小写及拼写PascalCamelNotBitFlagbitFlagBitflagCallbackcallbackCallBackCanceledcanceledCancelledDoNotdoNotDontEmaildmailEMailEndpointdndpointEndPointFileNamefileNameFilenameGridlinegridlineGridLineHashtablehashtableHashTableIdidIDIndexesindexesIndicesLogOfflogOffLogOutLogOnlogOnLogInMetadatametadataMetaData, metaDataMultipanelmultipanelMultiPanelMultiviewmultiviewMultiViewNamespacenamespaceNameSpaceOkokOKPipiPIPlaceholderplaceholderPlaceHolderSignInsignInSignOnSignOutsignOutSignOffSqlsqlSQLUserNameuserNameUsernameWhiteSpacewhiteSpaceWhitespaceWritablewritableWriteable通用命名约定通用命名约定讨论的是如何为库元素选择最适当的名称。这些准则适用于所有标识符。后面各节讨论特定元素（如命名空间或属性）的命名。选择名称1.选择易读的标识符名称。例如，英文属性名称 HorizontalAlignment 比 AlignmentHorizontal 更具可读性。可读性比简洁性更重要。属性名称 CanScrollHorizontally 比 ScrollableX（指 X 轴，但意义不明确）更好。2.不要使用下划线、连字符或任何其他非字母数字字符。3.不要使用匈牙利表示法。匈牙利表示法是在标识符中使用一个前缀对参数的某些元数据进行编码，如标识符的数据类型。4.避免使用与常用编程语言的关键字冲突的标识符。虽然符合 CLS 的语言必须提供将关键字用作普通字的方法，最佳做法不要求强制开发人员了解如何实现。对于大多数编程语言，语言参考文档都会提供语言所使用的关键字列表。缩写和首字母缩写词通常，不应使用缩写或首字母缩写词。这类名称的可读性较差。同样，要确定某个首字母缩写词是否已受到广泛认可也是很困难的。不要将缩写或缩略形式用作标识符名称的组成部分。例如，使用 OnButtonClick 而不要使用 OnBtnClick。除非必要，不要使用任何未被广泛接受的首字母缩写词。语言特定的名称对于类型名称，应使用语义上有意义的名称而不要使用语言特定的关键字。例如，名称 GetLengt