《.NET 设计规范》第 3 章 命名规范
《.NET 规范》第 3 章 命名规范
3.1 大小写约定
要把 PascalCasing 用于由多个单词构成的命名空间、类型以及成员的名字。
要把 camelCasing 用于参数的名字。
要把两个字母的首字母缩写词全部大写,除非它是 camelCasing 风格的参数名的第一个单词。
要把由三个或三个以上字母组成的首字母缩写词的第一个字母大写。只有第一个字母大写,除非首字母缩写词是 camelCasing 风格的标识符的第一个单词。
不要把 camelCasing 风格的标识符头部的任何首字母缩写词的任何字母大写,无论首字母缩写词的长度是多少。
不要把所谓闭合形式的复合词中每个单词的首字母大写。
不要以为所有的编程语言都是区分大小写的,实际情况并非如此。不应该仅仅通过大小写来区分名字。
3.2 通用命名约定
要为标识符选择易于阅读的名字。
要更看重可读性,而不是更看重简洁性。
不要使用下划线、连字符以及其他任何既非字母数字的字符。
不要使用匈牙利命名法。
避免使用与广泛使用的编程语言的关键字有冲突的标识符。
不要使用缩写词和缩略词作为标识符名字的组成部分。例如,要使用 GetWindow,而不用 GetWin。
不要使用未被广泛接受的首字母缩写词,即使是被广泛接受的首字符缩写词,也只应该在必需的时候才使用。
要给类型名使用语义上有意义的名字,而不要使用语言特有的关键字。
要使用 CLR 的通用类型名,而不是使用语言特有的别名 - 如果除了类型之外,标识符没有其他的语义。
要使用常见的名字,比如 value 或 item,而不要重复类型的名字 - 如果除了类型之外,标识符没有其他的语义,而且参数的类型无关紧要。
要在创建已有 API 的新版本时使用与旧 API 相似的名字。
要优先使用后缀而不是前缀来表示已有 API 的新版本。
考虑使用全新但有意义的标识符,而不是简单地给已有标识符添加后缀或前缀。
要使用数字后缀来表示已有 API 的新版本 - 如果已有 API 的名字是唯一有意义的名字(也就是说,它是一个工业标准),不适宜添加后缀(或改名)。
不要在标识符中使用“Ex”(或类似的)后缀来区分相同 API 的不同版本。
要引入对 64 位整数(long)而非 32 位整数进行操作的新版 APi 时使用“64”后缀。只有当已经存在 32 位的 API 时才需要采用这种方法,对只有 64 位版本的全新 API 则不需要这样做。
3.3 程序集和 DLL 的命名
3.4 命名空间的命名
要用公司名称作为命名空间的前缀,这样就可以避免与其它公司使用相同的的名字了。
要使用稳定的、与版本无关的产品名称作为命名空间的第二层。
不要根据公司的组织架构来决定命名空间的层次结构,因为公司内部组织的名称一般经过一段时间后可能会改变。
要使用 PascalCasing 大小写风格,并用点号来分隔命名空间的各部分。如果商标使用了非传统的大小写风格,那么即使改风格与常规的大小写风格相悖,也还是应该遵循商标的大小写风格。
考虑在适当地时候在命名空间中使用复数形式。
不要用相同的名字来命名命名空间以及位于该命名空间的类型。
不要引入太一般化的类型名,比如: Element、Node、Log 以及 Message。
不要给类型起会与核心命名空间中的任何类型产生冲突的名字。
不要给类型起会与同一技术中的其它类型产生冲突的名字。
不要在技术命名空间和应用程序模型命名空间的类型之间引入类型名冲突(除非不打算将该技术与该应用程序模型一起使用)。
3.5 类、结构和接口的命名
要用名词或名词短语来给类和结构命名。在命名时要使用 PascalCasing 大小写风格。这使类型名和方法区分开,后者采用动词短语来命名。
要用形容词短语来给接口命名,在少数情况下也可以使用名词或名词短语。
不要给类名加前缀。
考虑在派生类的末尾使用基类的名字。
要让接口的名字以字母 I 开头,这样可以显示出该类型是一个接口。
要确保一对类/接口的名字只相差一个“I”前缀,如果该类是该接口的标准实现。
要用描述性的名字来命名泛型类型参数-除非一个字母就可以说明含义就无需使用描述性的名字。
考虑用单个字母 T 来命名参数类型 - 如果类型只有一个类型参数并且类型参数只有一个字母。
要给描述性的类型参数名加上 T 前缀。
考虑在类型参数名中显示出施加于该类型参数上的约束。
要遵循描述的规范 - 如果要从 .NET 框架的类型派生新类,或者要实现 .NET 框架中的类型。
要用单数名词来命名枚举类型,除非它表示的是位域。
要用复数名词来命名表示位域的枚举类型,这样的枚举类型也成为标记枚举。
不要给枚举类型的没名字添加“Enum”后缀。
不要给枚举类型的名字添加“Flag”或“Flags”后缀。
不要给枚举类型值的名字添加前缀。
3.6 类型成员的命名
要用名词、名词短语或形容词来命名属性。
不要让属性名看起来与“Get”方法的名字相似。
要用描述集合中项目短语的复数形式来命名集合属性,而不要使用短语的单数形式加“List”或“Collection”后缀。
要用肯定性的短语(CanSeek 而不是 CantSeek)来命名布尔属性。如果有帮助,还可以有选择性地给布尔属性添加“Is”、“Can”或“Has”等前缀。
考虑用属性的类型名来命名属性。
要用动词或动词短语来命名事件。
要用现在时和过去时来赋予事件名之前和之后的概念。
不要用“Before”和“After”前缀或后缀来区分前置事件和后置事件。
要在命名事件处理函数(用作事件类型的委托)时加上“EventHandler”后缀。
要在事件处理函数中用 sender 和 e 作为两个参数的名字。
要在命名事件的的参数类时加上“EventArgs”后缀。
要在命名字段时使用 PascalCasing 大小写风格。
要用名词、名词短语或形容词来命名字段。
不要给字段名称加前缀。
3.7 参数的命名
要在命名参数时使用 camelCasing 大小写风格。
要使用具有描述性的参数名。
考虑根据参数的意思而不是参数的类型来命名参数。
要使用 left 和 right 来命名重载二元操作符的参数 - 如果参数没有具体的含义。
要使用 value 来命名重载一元操作符的参数 - 如果参数没有具体的含义。
考虑使用有意义的名字来命名重载操作符的参数 - 如果这样做可以清晰地表达名字的意义。
不要在命名重载操作符的参数时,使用缩写或数字编号。
3.8 资源的命名
要在命名资源键时使用 PascalCasing 大小写风格。
要使标识符的名字具有描述性而不是使名字变短。
不要使用各主要 CLR 编程语言特有的关键字。
要在命名资源时仅使用字母、数字和下划线。
要在命名异常消息的资源时遵循下面的命名约定。
【出处】http://www.cnblogs.com/liqingwen/p/7152673.html
《.NET 设计规范》第 3 章 命名规范的更多相关文章
- .NET设计规范————命名规范
NET设计规范:约定.惯用法与模式———命名规范 前言: 最近在看<.NET设计规范:约定.惯用法与模式>一书,主要还是讲.NET的设计规范,以前对这一块也不是特别在意, ...
- NET设计规范(二) 命名规范
http://blog.csdn.net/richnaly/article/details/6280294 第2章 命名规范 2.1. 大小写约定 2.1.1. 标识符的大小写规 ...
- 3.命名规范《.NET设计规范》
3.命名规范 3.1 大小写约定 使用合适的大小写增强名字可读性. 3.1.1 标识符的大小写规则 标识符的每个单词首写字幕大写.不要用下划线. PascalCasing camelCasing Pa ...
- 第四章 android 命名规范和编码规范
书里面讲的比较常见,单个人也是有不同的观点: 因为android绝大部分使用java开发的,因此java相关规范适用于android: Google Style: 英文地址:http://google ...
- [规则原则定理]规则原则定理章3Java命名规范
JAVA命名规范 驼峰法则: 将所有字母都小写(包括缩写),然后将单词的第一个字母大写. 每个单词的第一个字母都大写,来得到大驼峰式命名. 除了第一个单词,每个单词的第一个字母都大写,来得到(小)驼峰 ...
- Swift常量和变量以及命名规范
我们在上一章中介绍了如何使用Swift编写一个HelloWorld小程序,其中就用到了变量.常量和变量是构成表达式的重要组成部分.常量在声明和初始化变量时,在标识符的前面加上关键字let,就可以把该变 ...
- Web UI 网站用户界面设计命名规范
Web UI 网站用户界面设计命名规范 WEB UI设计命名规范,也就是网站用户界面设计(网页设计)命名规范. 这套规范并非单纯的CSS.html或JavaScript命名规范,它涉及了很多使用Pho ...
- C语言常见命名规范
C语言常见命名规范 1 常见命名规则 比较著名的命名规则首推匈牙利命名法,这种命名方法是由Microsoft程序员查尔斯·西蒙尼(Charles Simonyi) 提出的.其主要思想是“在变量和函 ...
- mysql命名规范
1.数据库表命名规范: (1)表名前应该加上前缀,表的前缀一个用系统或模块的英文名称缩写,前缀全部大写或首字母大写,表名中包含的单词首字母大写. (2)数据库表名应该有意义,并且易于理解,最好使用可以 ...
随机推荐
- Oracle 11G Client 安装就可以用上Oracle11G啦,不用傻傻的安装2G多的Oracle啦,安装特别简单,使用起来更简单
下载地址: http://download.oracle.com/otn/nt/oracle11g/112010/win32_11gR2_client.zip 先将下载下来的ZIP文件解压,并运行se ...
- 队列的存储结构的实现(C/C++实现)
存档 #include "iostream.h" #include "stdlib.h" #define max 20 typedef char elemtyp ...
- BZOJ 3211: 花神游历各国【线段树区间开方问题】
3211: 花神游历各国 Time Limit: 5 Sec Memory Limit: 128 MBSubmit: 3514 Solved: 1306[Submit][Status][Discu ...
- BZOJ 3680: 吊打XXX【模拟退火算法裸题学习,爬山算法学习】
3680: 吊打XXX Time Limit: 10 Sec Memory Limit: 128 MBSec Special JudgeSubmit: 3192 Solved: 1198[Sub ...
- Arduino 开源库 u8glib2 之 图标显示【原创】
Arduino 开源库 u8glib2 研究之 图标显示 -----------------关于drawXBM drawXBMP函数使用的研究 因为心血来潮,近来想做一个 ...
- chorme调试Paused in debugger问题解决
最近出现的问题,使用chorme调试代码总是这个状态(Paused in debugger[debug的时候暂停了]): 一刷新就这样,非常的不舒服.当然你可以选择多按几次F8跳出,下面提供几种方式解 ...
- Oracle_索引
Oracle_索引 索引类似字典的和课本目录,是为了加快对数据的搜索速度而设立的.索引有自己专门的存储空间,与表独立存放. 索引的作用:在数据库中用来加速对表的查询,通过使用快速路径访问方法快速定位数 ...
- c++---天梯赛---大笨钟
★题目: ★思路分析: 对可能的情况进行分类处理.在这里我把它们分成了3大类. ①不在敲钟时间 ②在敲钟时间但为整点 ③在敲钟时间且不为整点. 在敲钟时间段内我们可分别对晚8点前后进行分类讨论, 我们 ...
- 织梦CMS首页调用分类信息栏目及列表方法
不懂代码,搜索学习一晚上,都是说调用特定栏目分类信息列表的,用这个代码 {dede:arclistsg row='10' titlelen='24' orderby='pubdate' channel ...
- Idea Maven创建Web项目
1.创建Maven项目 1.1File->New->Project 1.2填写GroupId和ArtifactId 1.3直接Finish,然后等一会,等Maven加载完 完成以后的项目结 ...