C开发_规范.docVIP

DS.YF.2011.01.003 C#开发规范 文件状态： [ ] 草稿 [ ] 正在修改 [√ ] 正式发布 受控状态： [√ ] 受控 [ ] 非受控 当前版本： V1.4 文 件 名： C#开发_规范.doc 作 者： 路阳 审 核 人： 杜渂、何共晖 批 准 人： EPG 必威体育官网网址等级： 内部公开 批准日期： 修订 日期 版本号 修订说明 修订人 2011-2-28 1.0 体系文件编写完成，评审通过后建立基线。 代斯 2012-06-14 1.1 完善编码规范，并增加设计规范。 路阳 2012-06-18 1.2 EPG进行审核，对封面和修订部分进行了修改。 EPG 2012-06-25 1.3 根据EPG提供建议完善规范。 路阳 2012-06-25 1.4 EPG对文档进行审核，并在公司内部正式发文通告。 EPG 目　录 1 Introduction 简介 5 1.1 Purpose 目的 5 1.2 Scope 范围 5 2 Glossary 术语表 5 3 C#开发规范 6 3.1 概述 6 3.1.1 规范制定原则 6 3.1.2 编程标准 6 程序结构要求 6 可读性要求 6 结构化要求 7 正确性与容错性要求 7 可重用性要求 8 3.1.3 术语定义 8 Pascal大小写 8 Camel大小写 8 3.2 代码外观 8 3.2.1 列宽 8 3.2.2 换行 8 3.2.3 缩进 8 3.2.4 空行 9 3.2.5 空格 9 3.2.6 括号 - () 9 3.2.7 花括号 - {} 10 3.3 程序注释 10 3.3.1 注释概述 10 3.3.2 文件注释 11 3.3.3 类注释 12 3.3.4 文档型注释 12 3.3.5 多行注释 13 3.3.6 单行注释 13 3.3.7 注释标签 13 3.4 声明 16 3.4.1 每行声明数 16 3.4.2 初始化 16 3.4.3 位置 16 3.4.4 类和接口的声明 17 3.4.5 变量的声明 17 3.4.6 常量 17 3.5 命名规范 18 3.5.1 命名概述 18 3.5.2 大小写规则 18 3.5.3 缩写 20 3.5.4 文件命名 21 3.5.5 用户控件命名 21 3.5.6 命名空间 22 3.5.7 类 22 3.5.8 接口 23 3.5.9 属性 (Attribute) 23 3.5.10 枚举 (Enum) 23 3.5.11 参数 24 3.5.12 方法 24 3.5.13 属性 (property) 24 3.5.14 事件 26 3.5.15 常量 (const) 27 3.5.16 变量 27 3.5.17 静态变量 28 3.5.18 集合 28 3.5.19 措词 28 3.6 语句 29 3.6.1 每行一个语句 29 3.6.2 复合语句 29 3.6.3 return 语句 30 3.6.4 if、 if-else、if else-if 语句 30 3.6.5 for、foreach 语句 30 3.6.6 while 语句 31 3.6.7 do - while 语句 31 3.6.8 switch - case 语句 31 3.6.9 try - catch 语句 32 3.6.10 using 块语句 32 3.6.11 goto 语句（不提倡使用） 32 3.7 控件命名规划 33 3.7.1 命名方法 33 3.7.2 主要控件名简写对照表 33 3.8 其他 34 3.8.1 表达式 34 3.8.2 类型转换 34 3.9 设计规范 34 3.9.1 类型设计规范 34 总体设计 34 类型和命名空间 34 类和结构之间的选择 35 类和接口之间的选择 35 静态类的设计 35 接口的设计 35 3.9.2 类设计 35 字段 35 属性 36 构造函数 36 方法 36 事件 36 成员方法重载 37 接口成员 37 虚成员方法 37 静态类 37 0 抽象类 38 3.9.3 错误和异常 38 抛出异常 38 异常处理 39 3.9.4 开发基本模式 40 3.10 简要实践指导 42 3.10.1 命名规范 42 3.10.2 编码实践 43 4 References 参考 45 4.1 Formats/Forms and Templates 格式/形式和模板 45 4.2 Referenced Documents 参考文档 45 5 Appendix 附录 45 C#开发规范 In