c#编程规范-.pdf





《c#编程规范-.pdf》由会员分享,可在线阅读,更多相关《c#编程规范-.pdf(31页珍藏版)》请在淘文阁 - 分享文档赚钱的网站上搜索。
1、东软集团有限公司C#编程规范2.0C#编程规范Version 2.0东软集团有限公司C#编程规范2.0目录第一章概述.4规范制定原则.4术语定义.4Pascal 大小写.4Camel 大小写.4文件命名组织.41.3.1文件命名.41.3.2文件注释.4第二章 代码外观.62.1列宽.62.2换行.62.3缩进.62.4空行.62.5空格.62.6括号-().72.7花括号-.7第三章 程序注释.93.4注释概述.93.2文档型注释.93.3类C注释.103.4单行注释.103.5注释标签.10第四章申明.144.1每行声明数.144.2初始化.144.3位置.144.4类和接口的声明.154
2、.5字段的声明.15第五章命名规范.165.1命名概述.165.2大小写规则.165.3缩写.175.4命名空间.175.5类.185.6接口.185.7属性(ATTRIBUTE).195.8枚举(ENUM).195.9参数.19东软集团有限公司C#编程规范2.05.10方法.205.11属性(PROPERTY).205.12事件.215.13常量(CONST).225.14字段.225.15静态字段.235.16集合.245.17措词.24第六章语句.256.1每行一个语句.256.2复合语句.256.3RETURN 语句.256.4IF、IF-ELSE、IF ELSE-IF 语句.256.
3、4 FOR、FOREACH 语句.266.5WHILE 语句.266.7.DO-WHILE 语句.276.8.SWITCH-CASE 语句.276.9.TRY-CATCH 语句.276.10.USING 块语句.286.11.GOTO 语句.28第七章控件命名规则.297.1命名方法.297.2主要控件名简写对照表.29第八章其他.298.1表达式.298.2类型转换.29附录一:匈牙利命名法.30东软集团有限公司C#编程规范2.0第一章概述规范制定原则1 方便代码的交流和维护。2 不影响编码的效率,不与大众习惯冲突。3 使代码更美观、阅读更方便。4 使代码的逻辑更清晰、更易于理解。术语定义P
4、ascal 大小写 将标识符的首字母和后面连接的每个单词的首字母都大写。可以对三字符或更多字符的标识符使用Pascal 大小写。例如:BackColorCamel 大小写标识符的首字母小写,而每个后面连接的单词的首字母都大写。例如:backColor文件命名组织1.3.1 文件命名1 文件名遵从Pascal 命名法,无特殊情况,扩展名小写。2 使用统一而又通用的文件扩展名:C#类 .cs1.3.2 文件注释 1在每个文件头必须包含以下注释说明 /*-/Copyright(C)2004东软集团有限公司 /版权所有。/文件名:/文件功能描述:/创建标识:/修改标识:/修改描述:/修改标识:/修改描
5、述:东软集团有限公司C#编程规范2.0/-*/文件功能描述只需简述,具体详情在类的注释中描述。创建标识和修改标识由创建或修改人员的拼音或英文名加日期组成。如:李轶 20040408一天内有多个修改的只需做一个在注释说明中做一个修改标识就够了。在所有的代码修改处加上修改标识的注释。东软集团有限公司C#编程规范2.0第二章 代码外观2.1列宽 代码列宽控制在110 字符左右。2.2换行 当表达式超出或即将超出规定的列宽,遵循以下规则进行换行 1、在逗号后换行。2、在操作符前换行。3、规则1优先于规则2。当以上规则会导致代码混乱的时候自己采取更灵活的换行规则。2.3缩进 缩进应该是每行一个Tab(4
6、 个空格),不要在代码中使用Tab字符。Visual Studio.Net设置:工具-选项-文本编辑器-C#-制表符-插入空格2.4空行空行是为了将逻辑上相关联的代码分块,以便提高代码的可阅读性。在以下情况下使用两个空行 1、接口和类的定义之间。2、枚举和类的定义之间。3、类与类的定义之间。在以下情况下使用一个空行 1、方法与方法、属性与属性之间。2、方法中变量声明与语句之间。3、方法与方法之间。4、方法中不同的逻辑块之间。5、方法中的返回语句与其他的语句之间。6、属性与方法、属性与字段、方法与字段之间。7、注释与它注释的语句间不空行,但与其他的语句间空一行。2.5空格在以下情况中要使用到空格
7、 1、关键字和左括符“(”应该用空格隔开。如while(true)东软集团有限公司C#编程规范2.0注意在方法名和左括符“(”之间不要使用空格,这样有助于辨认代码中的方法调用与关键字。2、多个参数用逗号隔开,每个逗号后都应加一个空格。3、除了.之外,所有的二元操作符都应用空格与它们的操作数隔开。一元操作符、+及-与操作 数间不需要空格。如 a +=c +d;a=(a+b)/(c*d);while (d+=s+)n+;PrintSize(“size is“+size +“n”);4、语句中的表达式之间用空格隔开。如 for (expr1;expr2;expr3)2.6括号-()1、左括号“(”不
8、要紧靠关键字,中间用一个空格隔开。2、左括号“(”与方法名之间不要添加任何空格。3、没有必要的话不要在返回语句中使用()。如 if(condition)Array.Remove(1)return 1 2.7花括号-1、左花括号“”放于关键字或方法名的下一行并与之对齐。如 if(condition)public int Add(int x,int y)2、左花括号“”要与相应的右花括号“”对齐。3、通常情况下左花括号“”单独成行,不与任何语句并列一行。东软集团有限公司C#编程规范2.0 4、if、while、do语句后一定要使用 ,即使 号中为空或只有一条语句。如 if(somevalue=1)
9、somevalue=2;5、右花括号“”后建议加一个注释以便于方便的找到与之相应的。如 while (1)if(valid)/if valid else /not valid /end forever东软集团有限公司C#编程规范2.0第三章程序注释3.4注释概述1、修改代码时,总是使代码周围的注释保持最新。2、在每个例程的开始,提供标准的注释样本以指示例程的用途、假设和限制很有帮助。注释样本应该是解释它为什么存在和可以做什么的简短介绍.3、避免在代码行的末尾添加注释;行尾注释使代码更难阅读。不过在批注变量声明时,行尾注释是合适的;在这种情况下,将所有行尾注释在公共制表位处对齐。4、避免杂乱的注
10、释,如一整行星号。而是应该使用空白将注释同代码分开。5、避免在块注释的周围加上印刷框。这样看起来可能很漂亮,但是难于维护。6、在部署发布之前,移除所有临时或无关的注释,以避免在日后的维护工作中产生混乱。7、如果需要用注释来解释复杂的代码节,请检查此代码以确定是否应该重写它。尽一切可能不注释难以理解的代码,而应该重写它。尽管一般不应该为了使代码更简单以便于人们使用而牺牲性能,但必须保持性能和可维护性之间的平衡。8、在编写注释时使用完整的句子。注释应该阐明代码,而不应该增加多义性。9、在编写代码时就注释,因为以后很可能没有时间这样做。另外,如果有机会复查已编写的代码,在今天看来很明显的东西六周以后
11、或许就不明显了。10、避免多余的或不适当的注释,如幽默的不主要的备注。11、使用注释来解释代码的意图。它们不应作为代码的联机翻译。12、注释代码中不十分明显的任何内容。13、为了防止问题反复出现,对错误修复和解决方法代码总是使用注释,尤其是在团队环境中。14、对由循环和逻辑分支组成的代码使用注释。这些是帮助源代码读者的主要方面。15、在整个应用程序中,使用具有一致的标点和结构的统一样式来构造注释。16、用空白将注释同注释分隔符分开。在没有颜色提示的情况下查看注释时,这样做会使注释很明显且容易被找到。17、在所有的代码修改处加上修改标识 的注释。18、为了是层次清晰,在闭合的右花括号后注释该闭合
12、所对应的起点。namespace Langchao.Procument.Web/namespace Langchao.Procument.Web3.2文档型注释该类注释采用.Net已定义好的Xml 标签来标记,在声明接口、类、方法、属性、字段都应该使用该类注释,以便代码完成后直接生成代码文档,让别人更好的了解代码的实现和接口。如/MyMethod is a method in the MyClass class./Heres how you could make a second paragraph in a description./for information about output
13、statements./public static void MyMethod(int Int1)东软集团有限公司C#编程规范2.0 3.3类 c 注释 该类注释用于 1 不再使用的代码。2 临时测试屏蔽某些代码。用法/*修改标识 修改原因.(the source code)*/3.4单行注释 该类注释用于1 方法内的代码注释。如变量的声明、代码或代码段的解释。注释示例:/注释语句 /private int number;或 /注释语句 private int number;2 方法内变量的声明或花括号后的注释,注释示例:if(1=1)/always true statement;/alway
14、s true3.5注释标签标签用法作用ctext为您提供了一种将说明中的文本标记为代码的方法。使用 将多行指示为代东软集团有限公司C#编程规范2.0text希望将其指示为代码的文本。码contentcontent段落文本。用于诸如或 等标记内,使您得以将结构添加到文本中。descriptionname 为方法参数名。将此名称用单引号括起来()。应当用于方法声明的注释中,以描述方法的一个参数。name要引用的参数名。将此名称用双引号括起来()。标记为您提供了一种指示词为参数的方法。可以处理XML 文件,从而用某种独特的方法格式化该参数。cref=member对可以通过当前编译环境进行调用的成员或
15、字段的引用。编译器检查到给定代码元素存在后,将member传递给输出XML 中的元素名。必须将member括在双引号()中。使您得以从文本内指定链接。使用指示希望在“请参阅”一节中出现的文本。cref=member对可以通过当前编译环境进行调用的成员或字段的引用。编译器检查到给定代码元素存在后,将member传递给输出XML 中的元素名。必须将member括在双引号()中使您得以指定希望在“请参阅”一节中出现的文本。使用 从文本descriptiondescription代码示例的说明。使用 标记可以指定使用方法或其他库成员的示例。一般情况下,这将涉及到 标记的使用。contentconten
16、t 为希望将其标记为代码的文本。记为您提供了一种将多行指示为代码的方法。使用 指示应将说明中的文本标记为代码description此处 description 为对象的摘要。应当用于描述类型成员。使用以提供有关类型本身的信息。descriptioncref=member对可从当前编译环境中获取的异常的引用。编译器检查到给定异常存在后,将member转换为输出XML 中的规范化元素名。必须将member括在双引号(标记使您可以指定类能够引发的异常。东软集团有限公司C#编程规范2.0)中。description说明。filename 包含文档的文件名。该文件名可用路径加以限定。将filename括
17、在单引号中()。Tagpath:filename中指向标记名的标记路径。将此路径括在单引号中()。name注释前边的标记中的名称说明符;名称具有一个id。id位于注释之前的标记的id。将此id 括在双引号中()。标记使您得以引用描述源代码中类型和成员的另一文件中的注释。这是除了将文档注释直接置于源代码文件中之外的另一种可选方法。标记使用XML XPath 语法。有关自定义 使用的方法,请参阅XPath 文档。termdescription termdescription term定义的项,该项将在text中定义。description目符号列表或编号列表中的项或者term的定义。块用于定义表或
18、定义列表中的标题行。定义表时,只需为标题中的项提供一个项。列表中的每一项用 块指定。创建定义列表时,既需要指定term也需要指定text。但是,对于表、项目符号列表或编号列表,只需为text提供一个项。列表或表所拥有的 块数可以根据需要而定。descriptioncref=member 对可以通过当前编译环境进行调用的成员或字段的引用。编译器检查到给定代码元素存在后,将member转换为输出XML 中的规范化元素名。必须将member括在双引号()中。description成员的访问的说明。标记使您得以将成员的访问记入文档。System.Security.PermissionSet使您得以指定
19、对成员的访问。description 标记是可以指定有关类或其他类型的概述信息的位置。是可东软集团有限公司C#编程规范2.0description成员的说明。以描述该类型的成员的位置。descriptiondescription返回值的说明。标记应当用于方法声明的注释,以描述返回值。property-descriptionproperty-description属性的说明。标记使您得以描述属性。请注意,当在Visual Studio.NET 开发环境中通过代码向导添加属性时,它将会为新属性添加 标记。然后,应该手动添加 标记以描述该属性所表示的值。东软集团有限公司C#编程规范2.0第四章申明4
20、.1每行声明数一行只建议作一个声明,并按字母顺序排列。如 int level;/推荐 int size;/推荐 int x,y;/不推荐4.2初始化 建议在变量声明时就对其做初始化。4.3位置 变量建议置于块的开始处,不要总是在第一次使用它们的地方做声明。如void MyMethod()int int1=0;/beginning of method blockif(condition)int int2=0;/beginning of if block .不过也有一个例外 for(int i=0;i maxLoops;i+).应避免不同层次间的变量重名,如 int count;.void MyM
21、ethod()if(condition)东软集团有限公司C#编程规范2.0int count=0;/避免.4.4类和接口的声明 1 在方法名与其后的左括号间没有任何空格。2 左花括号“”出现在声明的下行并与之对齐,单独成行。3方法间用一个空行隔开。4.5字段的声明不要使用是public 或protected 的实例字段。如果避免将字段直接公开给开发人员,可以更轻松地对类进行版本控制,原因是在维护二进制兼容性时字段不能被更改为属性。考虑为字段提供get 和 set 属性访问器,而不是使它们成为公共的。get 和set 属性访问器中可执行代码的存在使得可以进行后续改进,如在使用属性或者得到属性更改
22、通知时根据需要创建对象。下面的代码示例阐释带有get 和set 属性访问器的私有实例字段的正确使用。示例:public class Control:Component private int handle;public int Handle get return handle;东软集团有限公司C#编程规范2.0第五章命名规范5.1命名概述名称应该说明“什么”而不是“如何”。通过避免使用公开基础实现(它们会发生改变)的名称,可以保留简化复杂性的抽象层。例如,可以使用GetNextStudent(),而不是GetNextArrayElement()。命名原则是:选择正确名称时的困难可能表明需要进一
23、步分析或定义项的目的。使名称足够长以便有一定的意义,并且足够短以避免冗长。唯一名称在编程上仅用于将各项区分开。表现力强的名称是为了帮助人们阅读;因此,提供人们可以理解的名称是有意义的。不过,请确保选择的名称符合适用语言的规则和标准。以下几点是推荐的命名方法。1、避免容易被主观解释的难懂的名称,如方面名AnalyzeThis(),或者属性名xxK8。这样的名称会导致多义性。2、在类属性的名称中包含类名是多余的,如Book.BookTitle。而是应该使用Book.Title。3、只要合适,在变量名的末尾或开头加计算限定符(Avg、Sum、Min、Max、Index)。4、在变量名中使用互补对,如
24、min/max、begin/end 和open/close。5、布尔变量名应该包含Is,这意味着Yes/No 或True/False 值,如fileIsFound。6、在命名状态变量时,避免使用诸如Flag的术语。状态变量不同于布尔变量的地方是它可以具有两个以上的可能值。不是使用documentFlag,而是使用更具描述性的名称,如 documentFormatType。(此项只供参考)7、即使对于可能仅出现在几个代码行中的生存期很短的变量,仍然使用有意义的名称。仅对于短循环索引使用单字母变量名,如i或 j。可能的情况下,尽量不要使用原义数字或原义字符串,如For i=1 To 7。而是使用命
25、名常数,如For i=1 To NUM_DAYS_IN_WEEK以便于维护和理解。5.2大小写规则大写标识符中的所有字母都大写。仅对于由两个或者更少字母组成的标识符使用该约定。例如:System.IOSystem.Web.UI下表汇总了大写规则,并提供了不同类型的标识符的示例。标识符大小写示例类PascalAppDomain枚举类型PascalErrorLevel枚举值PascalFatalError事件PascalValueChange异常类PascalWebException 注意总是以Exception 后缀结尾。东软集团有限公司C#编程规范2.0只读的静态字段PascalRedValu
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- c# 编程 规范

限制150内