Enum命名原则-Read.doc

NET命名规范 词语选择 避免使用由经常使用的名称空间复制的类型名。类型名不能使用下列词语。 System Collections Forms UI 避免使用与常用关键词冲突的标识符。 标识符（包括参数名）中不要使用缩写。如果必须使用缩写任何超过两个字符以上的缩写都使用camel大写格式，即使这不是标准缩写。 Pascal大写：每个单词的第一个字母大写，例如BackColor Camel大写：除了第一个单词以外的每一个单词的第一个字母大写，例如backColor 名称空间 命名名称空间的一般规则如下： CompanyName.TechnologyName 这样，我们看到的名称空间应该是这样的： Microsoft.Office PowerSoft.PowerBuilder 注意：这只是一个原则。第三方公司可以选择其它的名字。 避免用公司名称或其它著名品牌的名称作为名称空间的前缀，这样会造成两个公布的名称空间有同一个名称的可能性。（例如，将微软提供的Office自动类命名为Microsoft.Office。） 使用Pascal大写方式，用逗号分隔逻辑成分（例如，Microsoft.Office.PowerPoint）。如果你的品牌使用的是非传统大写方式，那么一定要遵循你的品牌所确定使用的大写方式，即使这种方式背离了通常的名称空间大写规则（例如，NeXT.WebObjects，和ee.cummings。） 该用复数的时候要使用复数的名称空间名。例如，使用System.Collections而不是System.Collection。本规则的特例是品牌名称和缩写。例如：使用System.IO而不是System.IOs。 名称空间和类不能使用同样的名字。例如，有一个类被命名为Debug后，就不要再使用Debug作为一个名称空间名。 类的命名原则 用名词或名词短语命名类。 使用Pascal大写。 减少类名中缩写的使用量。 不要使用任何类前缀（比如C）。 不要使用带下划线的字符。 下面是一些正确命名的类名的例子。 public class FileStream { } public class Button { } public class String { } 接口命名原则 使用名词或名词短语，或者描述行为的形容词来命名接口。例如，IComponent（描述性名词），ICustomAttributeProvider（名词短语），和IPersistable（形容词）。 使用Pascal大写。 减少接口名中缩写的使用量。 不要使用带下划线的字符。 在接口名前加前缀I，以表示这个类型是一个接口。 不要在类名前加上前缀C。偶而情???下，需要在类名前加上I而并不表示它是一个接口。在这种情况下，只要I后面的字符是小写就可（例如，IdentityStore。） 当类是接口的标准执行时，定义这一对类/接口组合就要使用相似的名称。两个名称的不同之处只是接口名前有一个I前缀。 下面我们举个例子，来看看接口IComponent和它的标准执行，类Component。 public interface IComponent { } public class Component : IComponent { } public interface IServiceProvider{ } public interface IFormatable { } Enum命名原则 Enum需使用Pascal大写。 Enum值名需使用Pascal大写。 减少enum名中缩写的使用量。 Enum名前不要加前缀（例如，adxxx表示ADO enums，rtfxxx表示多信息文本enum，等等。）。 在enum类型上不要加Enum后缀。 Enum名称需使用单数名词。 比特域使用复数名词。 如果列举值在参数或属性中使用，需用一个enum来定义列举值。这样工具就可以知道一个属性或参数可能的值了。 public enum FileMode{ Create, CreateNew, Open, OpenOrCreate, Truncate } 如果数字值之间是逻辑或的关系，就使用Flags对属性进行自定义。 [Flags] public enum Bindings { CreateInstance, DefaultBinding, ExcatBinding, GetField, GetProperty, IgnoreCase, InvokeMethod, NonPublic, OABinding, SetField SetProperty, Static } 在封装一个Win32 API时，这个规则有一个特例。从一个Win32标头产生内部定义是很常见的。你可以使用Win32大写，这种形式下