要求变量定义,注释规范等等!
请大家帮帮忙吧!
小弟为这事给烦死了!
c#帮助里有一份
好啊!
命名指导原则:
看看MSDN,里面都有的
程序开发规范
一、总体要求
1、必须严格执行本规范以确保源代码的可读性及可维护性。
2、所有的程序文件都必须有注释文字,并严格按照本规范中的“注释规范”书写。
二、命名规范
1.1 概述
1、必须使用语标准英文单词,不允许使用中文拼音。
2、如果有名词,必须使用单数形式。
3、使用大小写混合格式,将连接的几个单词首字母大写。
4、必须在3至30个字母以内。
5、如果使用缩写,必须使用本规范附录的缩写范例。
1.2 文件命名规范
1、文件命名采用主谓结构,首字母大写。
2、文件和文件夹的名称应该精确地说明它们的用途。
1.3 函数命名规范
1、函数名和方法名以动词开始,首字母大写,如 SaveFileLog。
2、在命名函数时包括返回值的说明,如 GetFileName。
3、类名和属性名以名词开始,首字母大写,如 EmployeeName。
4、在不同的类中的属性,如果它们有相同的作用,则必须使用同样的名称。
1.4 变量命名规范
1、所有变量都必须有前缀,前缀使用2—4个字母,全部小写。
2、避免与数据字典中的数据元素名相同。
3、避免与函数名、方法名、类名和属性名相同。
4、避免使变量名为另一个变量名的一部分。
5、布尔变量名应该包含 Is,如 blnFileIsFound。
1.5 常量命名规范
1、常量所有字母都应该大写,单词之间用下划线连接。
三、注释规范
2.1 概述
1、注释必须使用中文及中文的标点符号。
2、每行注释的最大长度为100个字符。
3、将注释与注释分隔符用一个空格分开。
4、不允许给注释加外框。
5、编码的同时书写注释。
6、重要变量必须有注释。
7、变量注释和变量在同一行,所有注释必须对齐,与变量分开至少两个Tab键。
8、典型算法必须有注释。
9、在循环和逻辑分支的地方必须写上注释。
10、程序段或语句的注释在程序段或语句的上一行。
11、在代码交付之前,必须删掉临时的或无关的注释。
2.2 文件与函数的注释
1、文件和函数的头部都必须有概述注释信息。
2、文件和函数的概述注释应缩进1个空格。
3、文件概述注释信息必须包括以下内容:
(1) 文件名
(2) 属性
(3) 创建人
(4) 创建日期
4、函数概述注释信息必须包括以下内容:
(1) 功能
(2) 输入参数,标明意义和类型
(3) 返回值,标明意义和类型
(4) 作者
(5) 日期
帮助中有比较详细的介绍:
ms-help://MS.NETFrameworkSDK.CHS/cpgenref/html/cpconnamingguidelines.htm
ms-help://MS.VSCC/MS.MSDNVS.2052/vsintro7/html/vxoriManagingProjectsSolutions.htm
ms-help://MS.VSCC/MS.MSDNVS.2052/Vbcon/html/vbconRecommendationsForNamingComponents.htm
ms-help://MS.VSCC/MS.MSDNVS.2052/vsent7/html/vxconcodingtechniques.htm
MSDN里面比较详尽了
http://download.microsoft.com/download/0/a/c/0acb3585-3f3f-4169-ad61-efc9f0176788/CSharp.zip
ftp://aspxdown:cybertiger@211.147.4.162/