《编码命名规范(.net)(很全,很实用)》由会员分享，可在线阅读，更多相关《编码命名规范(.net)(很全,很实用)（9页珍藏版）》请在金锄头文库上搜索。
1、编码命名规范（.NET） （很全，很实用）一、命名约定1.常用命名术语说明Pascal 命名格式 将标识符的首字母和后面连接的每个单词的首字母都大写。可以对三字 符或更多字符的标识符使用 Pascal 大小写。例如：BackColorCamel 命名格式 标识符的首字母小写，而每个后面连接的单词的首字母都大写。例如： backColor2.名称空间命名创建命名空间的名称时应使用以下原则：“公司名称.技术名称.软件产品代号”或“公司名称.产品技术代号”例如：Nd.ClassLibrary.Charting 命名空间就表示 Nd 公司里的公用类库里的 Charting 画 图类库。又如：Net91
2、com.Movies.DataAccess 名称空间标识 91.COM 电影站的数据访问层程序 集。3.类命名 使用完整的单词，避免用缩写。比如 ButtonGrid 比 BtnGrd 要长，但是完整从而可读性好。一般使用名词。类通常表示一种对象，而对象一般使用具有名词性质的名称。异常类命名:类以 Exception 结尾，比如 class EQException: Exception4.局部变量命名私有字段、函数参数和函数内部声明的变量使用 camel Casing不使用的是用以指明字段作用域的前缀。如 s_作为共享字段或静态字段的前缀，以及把 g_作为全局变量的前缀。不使用用以指明数据类型
3、的匈牙利前缀表示法，如(strReturn)。在 Microsoft Visual Studio .NET 环境中，只要在代码编辑器中将鼠标移到域名上，就可以得到关于字段或变量的类型 信息。另外，类型前缀限制了开发者在需要时改变变量的类型的能力，或者更糟糕的是， 开发者改变了变量的类型，却没有为变量重新命名，从而产生具有误导性的代码。5.只读静态变量Pascal 大小写6.类私有变量_ + Pascal 大小写。如：_BackColor7.属性命名 使用 Pascal Casing。属性名称通常都是名词。例如 Text、SelectedIndex 和 Width。8.接口命名使用 Pascal
4、 Casing。在接口名称前缀添加前缀 I 。接口名称尽量具有描述性，并使用形容词，因为接口常常用于给一个类添加某种能力。 基于形容词的名称有 IComparable 和 IFormattable 等9.方法命名使用 Pascal Casing。方法名通常是动词。方法实现一个对象的行为功能。方法执行某些操作。方法名的例子 有 Read、Write、Start 和 Stop。当重载方法时，参数的顺序和命名要一致。定义方法名时不要使用缩写。方法参数 Camel 大小写结构10.事件命名使用 Pascal Casing。事件名称通常是动词。比如 Click、Load 和 Paint11.枚举类型 使
5、用 Pascal Casing。如：EQFormatConditionOperator。枚举值也是 Pascal，比如 EQFormatConditionOperator. Equal12.委托命名 delegateAfterOperationHandler，总是以 Handler 为后缀结尾13.类对象命名使用 obj 前缀Pascal 命名的方式，来告知我们这个变量是一个对象比如：EQApplication objApp = new EQApplication();14.AttributePascal 大小写，并以 Attribute 结尾15.控件命名ButtonbtnbtnOK Cal
6、endarcalCheckBoxchkchkReadOnly CheckBoxListchklCompareValidatorvalcCustomValidatorvalxDataGridgridDataListlistDropDownListddlHyperLinklnkImageimgImageButtonibtnLabellblLinkButtonlbtnListBoxlstPanelpnlRadioButtonradRadioButtonListradlRangeValidatorvalgRegularExpressionvaleRequiredFieldValidatorvalrTa
7、bletblTableCelltblcTableRowtblrTextBoxtxttxtLastName ValidationSummaryvals16.其它命名ConnectionconnCommandcmdParameterparamDataAdapteradptDataReaderdrDataSetdsDataTabledtDataRowrowDataColumncolDataRelationrelDataViewdv17.注意：不要使用两个字母一样，但大小写不一样的命名来做命名空间，否则在一些不区分大小 写的语言里将不能正确区分这些命名空间声明。例如：namespace ee.cumm
8、ings 和 namespace EE.cummings 这两个声明不要使用大小写区分参数的形式来创建方法。比如：void MyFunction(string a， string A)不要使用大小写的不同来分别命名一个属性。比如：int Color get，set int COLOR get，set 不要使用大小写的不同来分别命名一个方法的名字。比如：void calculate()void Calculate()不要使用标志名称的一部分作为该标志名称的缩写或简写。比如：GetWindow 简写为 GetWin。尽量避免用缩写方式来对方法的参数命名，即方法的参数命名尽量保持完整，让人一目了然。
9、尽量避免就一个字母的命名，如 i 或 t，而用 index 或 temp二、代码格式化1.的位置与各单独占一行。例如：if(x 5)/代码 2.if、if else 的格式if(condition) DoSomething();if(condition) DoSomething();else DoSomethingOther();if(condition) DoSomething(); else if(condition) DoSomethingOther();else DoSomethingOtherAgain();3.for、foreach 的格式/for 格式for(int i = 0;
10、 i 5; +i) / 代码/foreach 的格式foreach(int i in IntList) / 代码4.whileswitch 的格式/while 格式while(condition) / 代码/switch 的格式switch(condition) case A: .break;case B:.break;default:.break;5.try 的格式try . catch(Exception e) ./或者try . catch(Exception e) . finally .6.空格对于有两个或两个以上空格时，一般不要使用空格来表示缩进，使用 Tab逗号、分号之后有一个空格
11、如：TestMethod(a， b， c);操作符前后有一个空格，但是单目运算符除外（例如： !运算符） 。如：for(int i = 0; i 10; +i)7.在执行统一任务的各个语句组之间插入一个空行。8.名称空间写法，各类名称空间插入空行，同一类命命空间按字母序号排列如：using System;using System.Text;using System.Collections;using System.ComponentModel;using System.Data;using System.Drawing;using System.Web;using System.Web.Ses
12、sionState;using System.Web.UI;using System.Web.UI.WebControls;using System.Web.UI.HtmlControls;using net91com.Movies.DataAccess;using net91com.Movies.Business;using net91com.CommonComponent;三、代码注释 1.注释的目的a. 文字说明代码的作用 (即为什么要用编写该代码，而不是如何编写); b. 确指出该代码的编写思路和逻辑方法 ; c. 人们注意到代码中的重要转折点 ; d. 使代码的阅读者不必在他们的头脑
13、中仿真运行代码的执行方法2.对类文件进行属性注释说明/= =/ 公司：/ 项目名称：/ 模块名称：/ 开发人员：/ 开发日期：/ 功能简介：/ 最后修改时间：/ 修改人员：/= = 3.避免对很显然易懂的语句进行注释说明 4.代码应该能作到自我解释代码作用的功能。 5.注释来说明何时可能出错和为什么出错 6.在编写代码前进行注释，给类、属性或方法前面加上功能注释 7.注释的内容 a.实参/ 参数 参数类型 ， 参数用来做什么， 任何约束或前提条件 b.字段/属性 字段描述 ， 注释所有使用的不变量， 并行事件可见性决策c.类 类的目的 ，已知的问题 ， 类的开发/维护历史 ， 注释出采用的不变
14、量 ， 并行策略d.接口 目的 它应如何被使用以及如何不被使用e.局部变量 用处/目的 f.成员函数注释 成员函数做什么以及它为什么做这个 哪些参数必须传递给一个成员函数成员函数返回什么已知的问题任何由某个成员函数抛出的异常可见性决策成员函数是如何改变对象的包含任何修改代码的历史如何在适当情况下调用成员函数的例子适用的前提条件和后置条件 g.成员函数内部注释 控制结构 代码做了些什么以及为什么这样做局部变量难或复杂的代码处理顺序 8.增强注释的可读性a. 使用完整的语句。b. 避免使用缩写。c. 将整个单词大写，以突出它们的重要性。 9.请在每个 if 语句/switch 语句/循环语句的前面
15、加上注释四、类/接口成员设计1.设计类和方法时的原则创建更加容易调试和维护的方法创建具有强大内聚力的类创建高度专用的方法创建松散连接的方法尽量使方法具有独立性提高方法的扇入性降低方法的扇出性 2.名称空间引用using 声明一律以.NET 基础框架命名空间、第三方组件命名空间、最后是公司内部产品 命名空间排序。 using System;using System.Collections;using Microsoft.CSharp;using Sirc.Egss.FileExchangeServer; 3.成员排列规则尽量不要使用类 public 变量，用属性代替类成员以 internal、private、protected、public 排列。public 部分按照构造函数、属性、 方法、事件的顺序排列。 4.每个类文件名应尽量保持与内部类名一致 5.尽量避免手动去修改工具环境自动生成的代码 6.避免在一个类文件里放置多个类 7.一个类文件里应该有且仅有一个命名空间，避免在一个类文件里包含多个不同的命名空 间 8.避免在一个类文件里代码超过 500 行（除去自动生成的代码） 9.数据结构里，应该总是更倾向使用 C#的范型 generic 10.尽量缩小变量的作用域 11.接口设
