程序设计编码规范.docx

1、程序设计编码规范程序设计、编码规范目录1. 程序界面设计 41.1. Web网站结构规范 41.2. 客户端文件命名规范 41.2.1. Web页面命名规范 41.2.2. Windows Form页面命名规范 51.3. 界面中控件命名规范 51.3.1. Button控件命名规范 51.3.2. 输入、选择控件命名规范 71.3.3. DataGrid网格控件命名规范 71.3.4. 工具条控件命名规范 81.4. 菜单及菜单项命名规范 82. 程序编码规范 102.1. 代码格式 102.2. 接口、类、方法、属性命名规范 112.2.1. 接口及接口成员的命名规范 112.2.2. 类

2、的命名规范 112.2.3. 类方法命名规范 122.2.4. 类属性的命名规范 122.3. 注释规范 132.3.1. 整体注释规范： 132.3.2. 模块注释规范 132.3.3. 类属性注释规范 152.3.4. 方法注释规范 152.3.5. 代码间注释规范 152.4. 变量命名规范 153. 项目特定规范 161. 程序界面设计1.1. Web网站结构规范为了保证系统有一个统一的界面风格及布局风格，需在网站虚拟根目录下增下一个存放系统图片文件的Image目录和一个存放系统CSS的Css目录。程序中所用到的所有系统图片及CSS都将从此两个目录中进行引出。两个目录中都存放有不同风格

3、的图片，用户可以设置系统使用的风格。系统中使用的CSS的文件名统一命名为：OceanSoft.css1.2. 客户端文件命名规范系统中一般的单据的命名都必须按下面的规范命名：1.2.1. Web页面命名规范 新增单据的aspx页面的名称 = 代表此单据功能的英文单词 + Add.aspx，并尽量与页面对应的数据库表名相对应。例如：职员新增的aspx页面的名称为 ：EmployeeAdd.aspx 查询单据的aspx页面的名称 = 代表此单据功能的英文单词 + Qry.aspx 例如：职员查询的aspx页面的名称为 ：EmployeeQry.aspx 查询结果显示的aspx页面的名称 = 代表此

4、单据功能的英文单词 + Dts.aspx 例如：职员查询结果显示的aspx页面的名称为 ：EmployeeDts.aspx 单据主操作页面的名称= 代表此单据功能的英文单词 + Manage.aspx，并尽量与页面对应的数据库表名相对应。例如：职员信息维护的主操作aspx页面名称为 ：EmployeeManage.cs 其它界面的aspx页面名称=代表此单据功能的英文单词 +.aspx其它界面主要是指一些业务单据以外的界面。如参数设置等界面。如SysInforSetting.aspx1.2.2. Windows Form页面命名规范 新增单据的cs页面的名称 = frm+代表此单据功能的英文单

5、词 + Add.cs，并尽量与页面对应的数据库表名相对应。例如：职员新增的cs页面的名称为 ：frmEmployeeAdd.aspx 查询单据的aspx页面的名称 = frm+代表此单据功能的英文单词 + Qry.cs 例如：职员查询的cs页面的名称为 ：frmEmployeeQry.aspx 查询结果显示的cs页面的名称 = frm+代表此单据功能的英文单词 + Dts.cs 例如：职员查询结果显示的cs页面的名称为 ：frmEmployeeDts.cs 单据主操作页面的名称= frm+代表此单据功能的英文单词 + Manage.cs，并尽量与页面对应的数据库表名相对应。例如：职员信息维护的

6、主操作cs页面名称为 ：frmEmployeeManage.cs 其它界面的cs页面名称= frm+代表此单据功能的英文单词 +.cs其它界面主要是指一些业务单据以外的界面。如参数设置等界面。1.3. 界面中控件命名规范1.3.1. Button控件命名规范按钮类别按钮功能名称ID可用状态图片名称不可用状态图片名称标题TextCssClass排列序号登录(Login)登录按钮cmdLogincmdLogin.GIFCmdLogin_False.GIF登录1登录取消按钮cmdLoginCancelcmdLoginCancel. GIF取消2单据新增界面 (New)关闭按钮cmdNewClosec

7、mdNewClose.GIFcmdNewClose_False.GIF关闭Button1新增按钮cmdNewAddcmdNewAdd. GIFcmdNewAdd_False. GIF新增Button2保存按钮cmdNewSavecmdNewSave. GIFcmdNewSave_False. GIF保存Button3删除按钮cmdNewDeletecmdNewDelete. GIFcmdNewDelete_False. GIF删除Button4复制按钮cmdNewCopycmdNewCopy.GIFcmdNewCopy_False.GIF复制Button5查询按钮cmdNewSearchcmd

8、NewSearch. GIFcmdNewSearch_False. GIF查询Button6设置按钮cmdNewSettingcmdNewSetting. GIFcmdNewSetting_False. GIF设置Button7打印按钮cmdNewPrintcmdNewPrint.GIFcmdNewPrint.GIF打印Button8帮助按钮cmdNewHelpcmdNewHelpcmdNewHelp_False.GIF帮助Button9单据主界面(Main)新增按钮cmdMainAddcmdMainAdd. GIFcmdMainAdd_False. GIF新增Button1删除按钮cmdMa

9、inDeletecmdMainDelete. GIFcmdMainDelete_False. GIF删除Button2设置按钮cmdMainSettingcmdMainSetting. GIFcmdMainSetting_False. GIF设置Button3查询按钮cmdMainSearchcmdMainSearch. GIFcmdMainSearch_False. GIF查询Button4打印按钮cmdMainPrintcmdMainPrint.GIFcmdMainPrint_False.GIF打印Button5帮助按钮cmdMainHelpcmdMainHelp.GIFcmdMainHe

10、lp_False.GIF帮助Button6跳转页面按钮cmdMainGoTocmdMainGoTo.GIFcmdMainGoTo_False.GIFGo或转到7首页按钮cmdMainFirstcmdMainFirst.GIFcmdMainFirst_False.GIF首页Button8上一页按钮cmdMainPreviouscmdMainPrevious.GIFcmdMainPrevio_False.us.GIF上一页Button9下一页按钮cmdMainNextcmdMainNext.GIFcmdMainNext_False.GIF下一页Button10末页cmdMainLastcmdMai

11、nLast.GIFcmdMainLast_False.GIF末页Button11其它网页中的功能按钮确定按钮cmdOkCmdOk.GIFCmdOk_False.GIF确定Button取消按钮(服务器端)cmdCancelcmdCancel.GIFcmdCancel_False.GIF取消Button取消按钮（客户端）btnCancelbtnCancel.GIFbtnCancel_False.GIF取消/关闭Button新增按钮cmdAddcmdAdd.GIFcmdAdd_False.GIF新增Button修改按钮cmdEditcmdEdit.GIFcmdEdit_False.GIF修改Butt

12、on保存按钮cmdSavecmdSave.GIFcmdSave_False.GIF保存Button删除按钮cmdDeletecmdDelete.GIFcmdDelete_False.GIF删除Button选择按钮cmdSelectcmdSelect.GIFcmdSelect_False.GIF选择Button全部选择按钮cmdSelectAllcmdSelectAll.GIFcmdSelectAll_False.GIF全部选择Button4全部删除按钮cmdDeleteAllcmdDeleteAll.GIFcmdDeleteAll_False.GIF全部删除Button4日期选择按钮btnSe

13、lectDatebtnSelectDate.GIFbtnSelectDate_False.GIFSelectDateButton时间选择按钮btnSelectTimebtnSelectTime.GIFbtnSelectTime_False.GIFSelectTimeButton系统资料选择按钮btnSelectInfobtnSelectInfo.GIFbtnSelectInfo_False.GIFSelectInfoButton单据的选择按钮btnSelectBillbtnSelectBill.GIFbtnSelectBill_False.GIFbtnSelectBillButton 对于We

14、b页面：界面的所有按钮的命名将按服务器和客户端按钮的不同而有不同的命名。对于服务器端按钮的命名以小写字符“cmd”开头 + 按钮所代表含意的英文单词，每个英文单词的首字母需大写；而客户端的按钮的命名以小写字符“btn”开头 + 按钮所代表含意的英文单词，每个英文单词的首字母需大写。为了使用各类界面中的按钮有灵活的设置，将对界面中的按钮进行分类，从而引用不同的CssClass。其中：单据新增界面中工具栏中的按钮将统一引用CssClass：ToolbarNew，从而保证修改此CssClass时，只改变所有具有此工具栏的界面。单据的主界面中工具栏中的按钮将统一引用CssClass：ToolbarMa

15、in，从而保证修改此CssClass时，只改变所有具有此工具栏的界面。其它网页界面中的功能按钮中，所有两个字的按钮将引用相同的CssClass：Button；所有四个字的按钮将引用相同的CssClass：Button4。 对于Windows Form页面对于Windows Form中的按钮的命名以小写字符“cmd”开头 + 按钮所代表含意的英文单词，每个英文单词的首字母需大写；1.3.2. 输入、选择控件命名规范控件类型控件名前缀控件名引用CssClass备注Labellbl数据库字段名LabelTextBoxtxt数据库字段名TextBoxTextAreatxt数据库字段名TextArea多

16、行的TextBoxRadioButtonrdo数据库字段名RadioButtonRadioButtonListrdolst数据库字段名RadioButtonListCheckBoxchk数据库字段名CheckBoxCheckBoxListchklst数据库字段名CheckBoxListListBoxlst数据库字段名ListBoxListBoxListlstlst数据库字段名ListBoxListDropDownListdrp数据库字段名DropDownList以上规范适合于Web页面及Windows Form页面。1.3.3. DataGrid网格控件命名规范为了便于在程序开发中对网格控件的

17、控制，一个界面中网格控件名称为统一为datagrid1，如果此界面中有多个控件，可分别命名为datagrid2、datagrid3datagridn。对于Web DataGrid控件的CSS引用规范如下：网格元素引用CssClass说明对应的DataGrid项网格本身Tabel设置网格本身的样式DataGrid或客户端TabelDataGrid交替项TabelAlternDataGrid交替项的样式AlternationItemStyleDataGrid标头项TabelHeadDataGrid标头的样式HeaderStyleDataGrid普通项TabelItemDataGrid普通项的样式I

18、temStyleDataGrid脚注项TabelFootDataGrid脚注的样式FooterStyleDataGrid编辑项TabelEditDataGrid编辑项的样式EditItemStyleDataGrid选定项TabelSelectDataGrid选定项的样式SelectedItemStyleDataGrid分页项TabelPageDataGrid分页项的样式PagerStyle 每个DataGrid在设置时，必须设置以上的CssClass项及相应的控件名称。1.3.4. 工具条控件命名规范GroupIDCaption按钮IDToolTipText1新增tbrNew新增1保存tbrS

19、ave保存1删除tbrDelete删除2导入tbrImport数据导入2导出tbrExport数据导出3打印tbrPrint打印3预览tbrPreview打印预览4插行tbrInsertRow插入行4删行tbrRemoveRow删除行5审核tbrCheck审核5反审tbrUnCheck取消审核6查看tbrView查看资料卡片6查找tbrBlur模糊查找7退出tbrExit1.4. 菜单及菜单项命名规范Menu_LevelMenu_CaptionMenu_NameMenu_ShortCutDescription1文件(&F)mnuFile1-1新建(&N)mnuFileNewCtrl+N新增一张

20、单据1-2保存(&S)mnuFileSaveCtrl+S保存单据信息1-3删除(&D)mnuFileDeleteCtrl+D删除当前单据1-4清空(&C)mnuFileClearAlt+Bksp清空当前单据的信息间隔MnuFileSp21-5数据导入(&I)MnuFileImportCtrl+I使用模板1-6数据导出(&E).mnuFileExportCtrl+E保存当前单据为模板间隔MnuFileSp31_7打印(&P)mnuFilePrintCtrl+P打印当前数据1_8打印预览(&V)mnuFilePreview预览当前数据间隔MnuFileSp21_9退出(&Q)MnuFileQuit

21、Ctrl+Q退出当前的操作2编辑(&E)MnuEdit2-1插入行(&I)mnuEditInsertRowShift+Ins在当前位置插入明细行2-2删除行(&R)mnuEditRemoveRowShift+Del删除当前的明细行间隔MnuEditSp12-3清空网格mnuEditClearGrid如果状态条上用到以ClearGrid命名,否则与清除界面时冲突间隔MnuEditSp32-4剪切行(&T)mnuEditCutCtrl+X2-5复制行(&C)mnuEditCopyCtrl+C2-6粘贴行(&P)mnuEditPasteCtrl+P3操作&O)MnuOperate3_1审核(&C)m

22、nuOperateCheck3_2取消审核(&U)mnuOperateUnCheck间隔MnuEditSp13-3查看消息(&V)mnuOperateViewMessageF63-4发送消息(&S)mnuOperateSendMessageF74查看(&V)MnuView4-1资料卡片(&C)mnuViewCardF5查看各种资料的卡片4-2模糊查找(&B)mnuViewBlurF2间隔MnuViewSp24_3刷新(&F)MnuViewRefreshF9刷新查询的数据5帮助(&H)MnuHelpF15_1内容(&C)mnuHelpContent5_2索引(&I)mnuHelpIndex间隔m

23、nuHelpSp15_3公司主页 (&W)mnuHelpWeb间隔mnuHelpSp25_4关于(&A)mnuHelpAbout特殊单据、特殊窗体菜单定义1显示/隐含列(&H)MnuViewHideCol设置当前网格格式(显示/隐藏列)2排序(&S)MnuViewSort3升序(&A)mnuViewAsc4降序(&D)mnuViewDesc5全部选定(&A)mnuViewAll6反向选择(&R)mnuViewReserve7向导(&W)mnuOperateWizards2. 程序编码规范2.1. 代码格式 所有的缩进为4个空格，不允许保留制表符，因为不同的编辑器制表符的长度不一样。 在代码中垂

24、直对齐左括号和右括号。if(x=0) Response.Write(用户编号必须输入！); 不允许以下情况：if(x=0) Response.Write(用户编号必须输入！); 或者：if(x=0) Response.Write(用户编号必须输入！); 代码行的最大长度。为了防止在阅读代码时不得不滚动源代码编辑器，每行代码在1024*800的显示频率下不得超过一显示屏（136个英文字符）。如果包括注释在内不得超过1.5显示屏的长度（176个英文字符）。 当一行被分为几行时，通过将串联运算符放在每一行的末尾而不是开头，清楚地表示没有后面的行是不完整的。例如：string mStrSql =INS

25、ERT INTO PAS_CM_RewardPunlish(RPLevelDetail,RPType, “+ “UserGUID,RPID,Memo,RPReason,RPDate,Status,AddIP , “ + “RPType,UserGUID,RPID,Memo,RPReason,RPDate,Status,AddIP; 编写 SQL 语句时，对于关键字使用全部大写；对于数据库元素（如表、列和视图）使用大小写混合。 将大的复杂代码节分为较小的、易于理解的模块。为了便于代码的阅读及维护，规定每个方法、函数的代码最长不得超过100行。最好每个方法的代码行数遵循不超过30行的原则，如果可以

26、拆分的方法尽量多拆分。这样利于系统的维护，也减少了bug的出现概率。 2.2. 接口、类、方法、属性命名规范2.2.1. 接口及接口成员的命名规范 接口的命名规范如下： 给接口名称加上字母 I 前缀，以指示该类型为接口。 用名词或名词短语，或者描述行为的形容词命名接口。例如，接口名称 IComponent 使用描述性名词。接口名称 ICustomAttributeProvider 使用名词短语。名称 IPersistable 使用形容词。各英文单词或缩写单词的首字母必须大写。接口中使用的英文单词数不得超过三个英文单词。 使用Pascal大小写。 少用缩写。 在定义类/接口对（其中类是接口的标准

27、实现）时使用相似的名称。两个名称的区别应该只是接口名称上有字母 I 前缀。使用要编写Employee类的接口，则其接口为Iemployee。这样在编码时就能很容易的辨认出某类的接口及某接口对应的类。 不要使用下划线字符 _。 接口方法的命名：接口方法的名称 = 代表接口功能的动词 或 由代表接口功能的动词+ 代表接口操作对象的名称组成。其中，动词由一个英文单词组成。一般不允许使用英文的缩写。操作对象的名称由一个或三个以下（包括三个）英文单词或英文单词缩写组成。每个英文单词或缩写单词的首字母应大写。例如：得到用户名的接口方法：GetUserName更改用户口令的接口方法：ChangePassword用户管理接口IEmployee增