C#开发规范二（命名准则）-526互联

二、C#命名准则

1.大小写约定

（1）为了区分标识符中的单词，将标识符中每个单词的首字母大写，避免使用下划线区分。

●PascalCasing约定，用于除参数名称以外的所有标识符，将每个单词（包括长度超过两个字母的首字母缩写词）的第一个字符大写，两个字母的首字母缩写词是一种特殊情况，其中两个字母都大写，如以下标识符：IOStream。

●camelCasing约定，仅用于参数名称，第一个单词首字母小写，其他单词首字母大写，如以下参数名称：ioStream。

（2）为了实现首字母大写，大多数组合术语都被视为单个单词。

2.通用命名约定

（1）选择易读的标识符名称

（2）可读性比简洁性更重要

（3）不要使用下划线、连字符或任何其他非字母数字字符

（4）避免使用与广泛应用编程语言关键字冲突的标识符

（5）不使用未被广泛接受的首字母缩写词，仅在必要时使用。

3.程序集和DLL的名称

程序集是托管代码程序的部署和标识单位，尽管程序集可跨一个或多个文件，但通常程序集和DLL一对一映射。

（1）为程序集DLL使用大量功能的名称

（2）考虑<Company>.<Component>.dll模式命名，<Component>包含一个或多个以句点分隔的子句。

4.命名空间的名称

（1）在命名空间名称前加上公司名称，以防不同公司的命名空间具有相同名称。

（2）在命名空间名称第二层使用稳定的、与版本无关的产品名称。

（3）不要使用组织层次结构作为命名空间层次结构中名称的主要部分。

（4）使用PascalCasing，并使用句点分隔命名空间组件。

（5）在适当情况下使用复数命名空间名称。

（6）不要对命名空间和该命名空间中的成员使用相同的名称。

（7）不要引入泛型类型名称，如Element、Node、Log、Message

5.类、结构和接口的名称

（1）使用PascalCasing用名词或名词短语命名类（抽象类）和结构（方法使用动词短语）

（2）使用形容词短语命名接口

（3）不要在类名前添加前缀，如“C”。

（4）考虑以基类名称作为派生类名称的结尾。

（5）必须在接口名称前加“I”，表示该类型为接口。

（6）在命名类型派生自或实现某些 .NET Framework 类型时，请务必遵循下表中描述的准则。

System.Attribute	必须将后缀“Attribute”添加到自定义属性类的名称中。
System.Delegate	●必须将后缀“EventHandler”添加到事件中使用的委托名称。 ●必须将后缀“Callback”添加到委托名称中，而不是用作事件处理程序的名称。 ●不要将后缀“Delegate”添加到委托。
System.EventArgs	●必须添加后缀“EventArgs”。
System.Enum	●不要派生此类。 ●不要添加后缀“Enum”或“Flag”。 ●不要在枚举值名称使用前缀
System.Exception	●必须添加后缀“Exception”
IDictionary IDictionary<TKey,TValue>	●必须添加后缀“Dictionary”
IEnumerable ICollection IList IEnumerable<T> ICollection<T> IList<T>	●必须添加后缀Collection
System.IO.Stream	●必须添加后缀“Stream”
CodeAccessPermission IPermission	●必须添加后缀“Permission”