《《精编》上海某公司绩效管理系统编程规范》由会员分享，可在线阅读，更多相关《《精编》上海某公司绩效管理系统编程规范（9页珍藏版）》请在金锄头文库上搜索。
1、 天强绩效管理系统编程规范一 命名规范1. 命名原则a. Pascal Casing属性每个单词的第一个字母大写，例如：BackColorb. Camel Casing 除了第一个单词以外的每个单词的第一个字母大写，例如：backColor.c. Upper Casing如果缩写字母的个数小于或等于2，那么所有的缩写字母都大写。3个以上的字母缩写采用Pascal Casing。例如：System.IO, System.Web.UI, System.CodeDom。2. 类的命名a. 用Pascal Casing 命名规则b. 谨慎的使用缩写c. 不要使用任何的前缀（例如：C_GetList）d
2、. 不要使用下划线命名e. 已所拥有的功能作为描述命名3. 方法的命名a. 用Pascal Casing 命名规则b. 谨慎的使用缩写c. 用动词或动词短语来命名（例如：public string GetAllList()）Data层的方法统一使用Insert()添加数据Update()修改数据GetModel()获取一条数据GetModelList()获取一个列表Delete()删除数据d. 不要使用下划线命名4. 属性的命名a. 用Pascal Casing 命名规则b. 谨慎的使用缩写c. 用名词或名词短语来命名d. 不要使用下划线命名e. 可以考虑用类型名称作为属性名称（例如： pub
3、lic Color Color）5. 接口的命名a. 用Pascal Casing 命名规则b. 谨慎的使用缩写c. 接口的前缀命名统一用I（方法本身的描述中有I开头的除外，例如：IGetPolicy）d. 不要使用下划线命名e. 接口名字用名词或者名词短语，或形容词来表述接口的行为6. 参数的命名a. 用Camel Casing 命名规则b. 谨慎的使用缩写c. 由本地的参数类型+描述性单词（例如：objCompanyList, strName, nCode）d. 不要使用保留参数（Win32 API）e. 参数的名字应该是描述性的7. 变量的命名a. 用Camel Casing 命名规则b
4、. 避免无意义的变量命名（如：string a = string.Empty()，但 for(int i=0;i5;i+)除外）c. 由本地的参数类型+描述性单词（例如：objCompanyList, strName, intCode）d. 不要使用保留参数（Win32 API）e. 参数的名字应该是描述性的8. 大小写敏感a. 不要出现两个只用大小写区分的命名空间b. 不要出现两个只用大小写区分的参数c. 不要出现两个只用大小写区分的同一命名空间的类型d. 不要出现两个只用大小写区分的同一类型属性e. 不要出现两个只用大小写区分的方法9. 类库的命名a. 要以系统的功能模块来划分类库，所有的
5、类库的命名空间用KPI. 开头b. 用Pascal Casing 命名规则c. 不要使用下划线命名d. 不能使用缩写e. 类库分为公共引用层，实体层，逻辑层和数据层类库f. 公共引用层命名 Commong. 实体层命名 KPI.Model，例如：KPI.Model.Syetemh. 逻辑层命名 KPI.Stategy. 例如：KPI.Stategy.Systemi. 数据层命名 KPI.Data. 例如：KPI.Data.System 10. 文件的命名a. 用Pascal Casing 命名规则b. 公共引用层文件命名参考类的命名c. Web网站内文件的命名 主要遵循 Pascal Casi
6、ng 命名规则d. 实体层文件命名分为 数据库实体，自定义实体, 条件实体。 e. 实体层数据库实体文件命名 数据库名称 + Model结尾命名f. 实体层自定义实体文件命名 功能描述名词 + Define结尾命名g. 实体层条件实体功能描述名词 + Condition结尾命名h. 逻辑层文件命名 功能描述名词i. 数据层文件命名 数据库名称二 编程规范1. 代码注释原则上平均每100行代码中要有2030行注释，视程序复杂程度而定。所有注释应使用中文。例如:/添加一个用户函数对于源文件和类，必须在注释中说明修改历史具体规范参见项目根目录下的CodingSample.cs2. 类和接口的注释在中
7、填写类的简要描述，中填写类的一些注意事项。Histroy填写修改记录。所有类和接口都要注释。类的操作注释由详细设计产物导出，编程人员补充完成从Title到History的部分。例如：/ / 接口定义了实体类的增、删、改、读 / （CRUD）方法，该接口的实现类将负责用户对象的简单管理。 / / / 接口仅定义实体对象的CRUD操作方法， / 并没有定义关联用户对象与群组、组织机构等的操作，这些业务逻辑操作的方法定义在/ 专门的关联操作接口及中。 / / Title: IUserManager / Copyright: * Software LTD.co Copyright (c) 2006 /
8、 Company: *有限公司/ Designer: */ Coder: 姜辉/ Reviewer: / Tester: * / Version: 1.0 / History:/2006-07-14 任维 创建/2006-07-15 任维 编码/ 2006-08-10 任维修改 根据外部用户需要,包装GetUserNameById()WEB服务方法.3. 类成员变量的注释类成员变量的注释如下例所示：/ / 用户的名称/ public string username;在声明前，利用.Net的格式来注释，原则上类的成员变量都要注释。4. 方法的注释/ / 根据指定的用户登录名、姓名及密码创建（注册
9、）一个新用户（）。 / / / 当满足如下任意情形之一时，创建用户的操作将会失败： / 1，指定的用户名在用户持久化存储中已存在 / 2，指定的用户名不合法（空值，空字符串，多个空格，包含除字母及数字以外的非法字符，长度 / 超过64） / 3，指定的用户密码不合法（空值，空字符串，多个空格，包含除字母及数字以外的非法字符，长 / 度小于6位或大于位64） / 4，指定的用户姓名不合法（空值，空字符串，多个空格，长度大于位64） / / 用户的登录名，该属性必须唯一，如“zhangsan” / 用户的名称，该属性可以重复，如多个用户均可以叫“张三” / 用户登录的密码 / 创建的新用户对象（）
10、 / 用户已经存在时所抛出的异常 / 用户登录名不合法时所抛出的异常/exception / 用户姓名不合法时所抛出的异常 / 用户登录密码不合法时所抛出的异常中填写该方法的主要功能描述，中填写该方法的注意事项，中填写方法的传入参数，以及各参数的意义。 填写函数返回值以及返回值的意义。注意在其中运用xml语法。所有的public及protected方法都要注释。5. 程序中的注释在程序中，采用 ”/”进行单行注释。所有程序中的分支语句需要注释分支条件意义，循环语句需要注释循环的起始条件和中止条件。/ 满足支付条件if (MeetPayCondition() / 循环遍历数组for ( int i = 0; i =或者=进行比较三 通用规范1. 判断与循环的注释对于大段的（超过20行）判断、循环语句，要加注释，对于判断语句（如if，switch），要说明判断的条件和程序的走向。对于循环语句（如while,do while,for），要说明循环继续和终止的条件。当有循环嵌套时,尽量把大循环放在内层.2. 缩写规范一个项目中用到的同一词语的缩写要求完全统一，如”Pro
