[点晴永久免费OA]C#编程规范
当前位置:点晴教程→点晴OA办公管理信息系统
→『 经验分享&问题答疑 』
一、概述1.1 规范制定原则 1 方便代码的交流和维护。 2 不影响编码的效率,不与大众习惯冲突。 3 使代码更美观、阅读更方便。 4 使代码的逻辑更清晰、更易于理解。 2.1 术语定义Pascal 大小写 将标识符的首字母和后面连接的每个单词的首字母都大写。可以对三字符或更多字符的标识符使用Pascal 大小写。例如: BackColor Camel 大小写标识符的首字母小写,而每个后面连接的单词的首字母都大写。例如: backColor
二、注释规范 2.1文件注释 1 在每个文件头必须包含以下注释说明 /*---------------------------------------------------------------- // Copyright (C) 2007 团队名 // 版权所有。 // 开发者: // 文件名: // 文件功能描述: //----------------------------------------------------------------*/ 2.2. 文档型注释 该类注释采用.Net已定义好的Xml标签来标记如:///<summary> ///方法说明 ///</summary> ///<para name="Int1">参数说明</para> public static void MyMethod(int Int1) { } 下表汇总了大写规则,并提供了不同类型的标识符的示例。
三、代码规范3.1每行声明数一行只建议作一个声明,并按字母顺序排列。如 int level; //推荐 int size; //推荐 int x, y; //不推荐 3.2 初始化 建议在变量声明时就对其做初始化。 3.3 类和接口的声明 1 在方法名与其后的左括号间没有任何空格。 2 左花括号 “{” 出现在声明的下行并与之对齐,单独成行。 3 方法间用一个空行隔开。 3.4 字段的声明不要使用是 public 或 protected 的实例字段。如果避免将字段直接公开给开发人员,可以更轻松地对类进行版本控制,原因是在维护二进制兼容性时字段不能被更改为属性。考虑为字段提供 get 和set 属性访问器,而不是使它们成为公共的。 get 和 set 属性访问器中可执行代码的存在使得可以进行后续改进,如在使用属性或者得到属性更改通知时根据需要创建对象。下面的代码示例阐释带有get 和 set 属性访问器的私有实例字段的正确使用。 示例: public class Control: Component { private int handle; public int Handle { get { return handle; } } } 四、 控件命名规则4.1 命名方法控件名简写+下划线+英文描述,英文描述首字母大写 4.2 主要控件名简写对照表控件名 简写 控件名 简写 Label lbl TextBox txt Button btn LinkButton lnkbtn ImageButton imgbtn DropDownList ddl ListBox lst DataGrid dg DataList dl CheckBox chk CheckBoxList chkls RadioButton rdo RadioButtonList rdolt Image img Panel pnl Calender cld AdRotator ar Table tbl RequiredFieldValidator rfv CompareValidator cv RangeValidator rv RegularExpressionValidator rev ValidatorSummary vs CrystalReportViewer rptvew 该文章在 2017/4/20 8:18:46 编辑过 |
关键字查询
相关文章
正在查询... |