第六章 C# 编码规范说明书.doc

C#编码规范 说明书 方正国际公安与地理信息事业部 2011年6月 文档修订说明表 序号 版本 产品版本 修订内容 修订人 审核人 修订时间 备注 1 V1.0 V 文档创建 杨凤霞 2011-07-08 2 3 4 5  目 录 1 目标 3 2 概述 3 3 总体要求 3 3.1 程序结构化 3 3.2 代码可读性 3 3.3 代码结构化 4 3.4 正确性与容错性 4 4 编码规范 4 4.1 文件结构 4 4.1.1 C# 文件 4 4.1.2 目录结构 4 4.2 缩进 5 4.2.1 换行 5 4.2.2 空格 5 4.3 注释 6 4.3.1 模块注释 6 4.3.2 单行注释 6 4.3.3 类注释 6 4.3.4 方法注释 6 4.4 声明 7 4.4.1 单行声明变量数 7 4.4.2 初始化 7 4.4.3 类和接口声明 7 4.5 功能语句 8 4.5.1 简单逻辑 8 4.5.2 if-else语句 8 4.5.3 For / Foreach 语句 9 4.5.4 While/do-while 语句 9 4.5.5 Switch 语句 9 4.5.6 Try-catch 语句 10 4.6 空白 10 4.6.1 空白行 10 4.6.2 参数条件之间的空白 11 4.6.3 表格式的样式 11 4.7 命名规范 12 4.7.1 大写 12 Pascal 风格 12 驼峰规则 12 大写风格 12 4.7.2 命名方法 12 类命名 12 接口命名 12 枚举命名 13 常量命名 13 参数命名 13 变量命名 13 方法命名 13 属性命名 13 事件命名 13 0 大写风格 13 4.8 开发习惯 14 4.8.1 可见性 14 4.8.2 不要硬编码数字 14 4.9 代码示例 14 4.9.1 作用域（“{}”）示例 14 5 控件命名规范以及一般用法 15 6 参考 18 7 附录 18 7.1 XML注释标记的使用 18 8 修改历史 21  目标 为本部门DotNet组的C#程序员制定一个统一的编码规范，最大限度减少不同程序员开发的代码间的差异。 概述 为了使应用程序的结构和编码风格标准化，便于阅读和理解编码好的编码约定可使源代码严谨、可读性强且意义清楚，与其它语言约定相一致，并且尽可能的直观。 程序结构化 程序结构清晰，函数功能简单易懂（单个函数的代码行数不超过100行） 代码可读性 保持注释与代码完全一致 每个源程序文件，都有文件头说明，详细见下节 每个函数，都有函数头说明，详细见下节 主要变量（结构、联合、类或对象）定义或引用时，注释能反映其含义 处理过程的每个阶段都有相关注释说明 在典型算法前都有注释, 同时算法在满足要求的情况下尽可能简单 利用缩进来显示程序的逻辑结构，缩进量一致并以Tab键为单位，定义Tab为 4个字节 循环、分支层次一般不应超过五层 代码简单的分支应该写在前面 不允许同行出现两个语句 空行和空白字符也是一种特殊注释 一目了然的语句不加注释 注释的作用范围可以为：定义、引用、条件分支以及一段代码 常量定义（DEFINE）有相应说明 代码结构化 禁止GOTO语句 用 CASE 实现多路分支 避免不必要的分支 用 IF 语句来强调只执行两组语句中的一组。尽量不使用 Else Return 尽量避免从循环引出多个出口 正确性与容错性 所有变量在调用前必须被初始化 不要比较浮点数的相等，如： 10.0 * 0.1 == 1.0 ， 不可靠 访问外部资源(数据库，外部文件)时使用规范的容错语句 例如: try { } catch { } finally { } 编码规范 文件结构 C# 文件 尽量不要让你的类或者文件太长,一般不应超过2000行代码。请按照功能划分你的代码，使结构保持清晰。一般情况下，一个文件应当只有一个类，并且文件名应该与类名保持一致。 目录结构 应该为每个名称空间(namespace)建立一个目录(例如，我们可以为名称空间MyProject.TestSuite.TestTier建立这样的目录：MyProject/TestSuite/TestTier)。这样做可以让你很快定位到指定名称空间下的类文件。 缩进 换行 如果表达式太长而一行无法写下时，请按照下列规范进行换行： 可以在逗号后面进行换行 可以在操作符号后进行换行 尽量选择在较高层处进行换行 换行后的新行应当与前一行中同级别的运算符对齐 例子： 方法调用换行： longMethodCall(expr1, expr2,???????????????ex