C#代码规范.docVIP

C# 代码规范 前言 本文档定义了一些通用的代码规范和准则，一般情况下本文档适用于项目组所有项目，特殊情况下，如果客户有自己的代码规范，以客户的代码优先。 大小写约定 大小写样式，本文中将出现两种大小写样式，这里先分别定义： Pascal大小写 将标识符的首字母和后面连接的每个单词的首字母都大写。可以对三字符或更多字符的标识符使用 Pascal 大小写。例如：BackColor Camel大小写 标识符的首字母小写，而每个后面连接的单词的首字母都大写。例如：backColor 匈牙利命名法 基本原则是：变量名=属性+类型+对象描述。 例如：lblName 标识符大小写规则 下表中列出常见的代码元素的样式规范和示例 标识符 规则 示例 类 Pascal AppDomain 枚举类型 Pascal ErrorLevel 枚举值 Pascal Warning 事件 Pascal ValueChanging, ValueChanged 异常类 Pascal WebException 只读的静态字段 Pascal CurrentUser 接口 Pascal IDisposable 方法 Pascal ToString 命名空间 Pascal System.Data 参数 Camel typeName 属性 Pascal Name 常量 全大写 MAXLENGTH, LENGTH_MAX Web或Win控件 匈牙利 txtName 除了遵循以上大小写约定外还需注意以下约定（除常量为特例）： 如果标识符由多个单词组成，请不要在各单词之间使用分隔符，如下划线（“_”）或连字符（“-”）等。而应使用大小写来指示每个单词的开头。 所有公共的成员如：方法、属性，都应使用Pascal大小写样式 首缩写词的大小写规则 首字母缩写词 首字母缩写词是由术语或短语中各单词的首字母构成的单词。 例如，HTML 是 Hypertext Markup Language 的首字母缩写。为了方便编码规范的实施，本文规定受字母缩写词必须至少为两个单词，正好为两个单词的首字母缩写词称其为“短型首字母缩写词”，两个单词以上的称其为“长型首字母缩写词” 单缩写词 单缩写词是一个单词的缩写。例如，ID 是 identifier 的缩写。 注意：可在标识符中使用的两个缩写词是 ID 和 OK。在采用 Pascal 大小写格式的标识符中，这两个缩写词的大小写形式应分别为 Id 和 Ok。如果在采用大小写混合格式的标识符中将这两个缩写词用作首个单词，则它们的大小写形式应分别为 id 和 ok。 首字母缩写词有以下大小写规则： 短型首字母缩写词在Pascal大小写样式中，两个字母都应大写。在Camel大小写样式中，如果是首个单词，两个字母都应小写。例如： 名为 DBRate 的属性是一个采用 Pascal 大小写格式的标识符，它使用短型首字母缩写词 (DB) 作为首个单词。 名为 ioChannel 的参数是一个采用大小写混合格式的标识符，它使用短型首字母缩写词 (IO) 作为首个单词。 长型首字母缩写词，在任何大小写样式中都视为一个单词。例如： 名为 XmlWriter 的类是一个采用 Pascal 大小写格式的标识符，它使用长型首字母缩写词作为首个单词。 名为 htmlReader 的参数是一个采用大小写混合格式的标识符，它使用长型首字母缩写词作为首个单词。 复合词的大小写规则： 所有复合词在任何大小写样式中都视为一个完整单词。 例如，hashtable 是一个紧凑格式的复合词，应将其视为一个单词并相应地确定大小写。如果采用 Pascal 大小写格式，则该复合词为 Hashtable;如果采用大小写混合格式，则该复合词为 hashtable。若要确定某个单词是否是紧凑格式的复合词，请查阅最新的词典。 区分大小写 大小写准则只是为了使标识符更易于阅读和辨认。不能将大小写规则用作避免库元素之间的命名冲突的手段。 通用命名约定 通用命名约定讨论的是如何为库元素选择最适当的名称。这些准则适用于所有标识符。后面各节讨论特定元素（如命名空间或属性）的命名。 名称的选择与命名原则 请选择易读的标识符名称 例如，英文属性名称 HorizontalAlignment 比 AlignmentHorizontal 更具可读性。 可读性比简洁性更重要 例如，属性名称 CanScrollHorizontally 比 ScrollableX（指 X 轴，但意义不明确）更好。 不要使用下划线、连字符或任何其他非字母数字字符 不要使用匈牙利表示法 匈牙利表示法是在标识符中使用一个前缀对参数的某些元数据进行编码，如标识符的数据类型。 避免使用与常用编程语言的关键字冲突的标识符 虽然符合 CLS 的语言