程序设计编码规范Word文档下载推荐.docx
《程序设计编码规范Word文档下载推荐.docx》由会员分享，可在线阅读，更多相关《程序设计编码规范Word文档下载推荐.docx（23页珍藏版）》请在冰豆网上搜索。
职员新增的cs页面的名称为：
frmEmployeeAdd.aspx
✓查询单据的aspx页面的名称=frm+代表此单据功能的英文单词+Qry.cs
职员查询的cs页面的名称为：
frmEmployeeQry.aspx
✓查询结果显示的cs页面的名称=frm+代表此单据功能的英文单词+Dts.cs
职员查询结果显示的cs页面的名称为：
frmEmployeeDts.cs
✓单据主操作页面的名称=frm+代表此单据功能的英文单词+Manage.cs，并尽量与页面对应的数据库表名相对应。
职员信息维护的主操作cs页面名称为：
frmEmployeeManage.cs
✓其它界面的cs页面名称=frm+代表此单据功能的英文单词+.cs
1.3.界面中控件命名规范
1.3.1.Button控件命名规范
按钮类别
按钮功能
名称ID
可用状态
图片名称
不可用状态
标题Text
CssClass
排列序号
登录（Login）
登录按钮
cmdLogin
cmdLogin.GIF
CmdLogin_False.GIF
登录
1
登录取消按钮
cmdLoginCancel
cmdLoginCancel.GIF
取消
2
单据新增界面（New）
关闭按钮
cmdNewClose
cmdNewClose.GIF
cmdNewClose_False..GIF
关闭
Button
新增按钮
cmdNewAdd
cmdNewAdd.GIF
cmdNewAdd_False..GIF
新增
保存按钮
cmdNewSave
cmdNewSave.GIF
cmdNewSave_False..GIF
保存
3
删除按钮
cmdNewDelete
cmdNewDelete.GIF
cmdNewDelete_False..GIF
删除
4
复制按钮
cmdNewCopy
cmdNewCopy.GIF
cmdNewCopy_False..GIF
复制
5
查询按钮
cmdNewSearch
cmdNewSearch.GIF
cmdNewSearch_False..GIF
查询
6
设置按钮
cmdNewSetting
cmdNewSetting.GIF
cmdNewSetting_False..GIF
设置…
7
打印按钮
cmdNewPrint
cmdNewPrint.GIF
打印
8
帮助按钮
cmdNewHelp
cmdNewHelp_False.GIF
帮助
9
单据主界面（Main）
cmdMainAdd
cmdMainAdd.GIF
cmdMainAdd_False..GIF
cmdMainDelete
cmdMainDelete.GIF
cmdMainDelete_False..GIF
cmdMainSetting
cmdMainSetting.GIF
cmdMainSetting_False..GIF
cmdMainSearch
cmdMainSearch.GIF
cmdMainSearch_False..GIF
cmdMainPrint
cmdMainPrint.GIF
cmdMainPrint_False..GIF
cmdMainHelp
cmdMainHelp.GIF
cmdMainHelp_False..GIF
跳转页面按钮
cmdMainGoTo
cmdMainGoTo.GIF
cmdMainGoTo_False..GIF
Go或转到
首页按钮
cmdMainFirst
cmdMainFirst.GIF
cmdMainFirst_False..GIF
首页
上一页按钮
cmdMainPrevious
cmdMainPrevious.GIF
cmdMainPrevio_False.us.GIF
上一页
下一页按钮
cmdMainNext
cmdMainNext.GIF
cmdMainNext_False..GIF
下一页
10
末页
cmdMainLast
cmdMainLast.GIF
cmdMainLast_False..GIF
11
其它网页中的功能按钮
确定按钮
cmdOk
CmdOk.GIF
CmdOk_False..GIF
确定
取消按钮（服务器端）
cmdCancel
cmdCancel.GIF
cmdCancel_False..GIF
取消按钮（客户端）
btnCancel
btnCancel.GIF
btnCancel_False..GIF
取消/关闭
cmdAdd
cmdAdd.GIF
cmdAdd_False..GIF
修改按钮
cmdEdit
cmdEdit.GIF
cmdEdit_False..GIF
修改
cmdSave
cmdSave.GIF
cmdSave_False..GIF
cmdDelete
cmdDelete.GIF
cmdDelete_False..GIF
选择按钮
cmdSelect
cmdSelect.GIF
cmdSelect_False..GIF
选择
全部选择按钮
cmdSelectAll
cmdSelectAll.GIF
cmdSelectAll_False..GIF
全部选择
Button4
全部删除按钮
cmdDeleteAll
cmdDeleteAll.GIF
cmdDeleteAll_False..GIF
全部删除
日期选择按钮
btnSelectDate
btnSelectDate.GIF
btnSelectDate_False..GIF
SelectDateButton
时间选择按钮
btnSelectTime
btnSelectTime.GIF
btnSelectTime_False..GIF
SelectTimeButton
系统资料选择按钮
btnSelectInfo
btnSelectInfo.GIF
btnSelectInfo_False..GIF
SelectInfoButton
单据的选择按钮
btnSelectBill
btnSelectBill.GIF
btnSelectBill_False.GIF
btnSelectBillButton
✓对于Web页面：
界面的所有按钮的命名将按服务器和客户端按钮的不同而有不同的命名。
对于服务器端按钮的命名以小写字符“cmd”开头+按钮所代表含意的英文单词，每个英文单词的首字母需大写；
而客户端的按钮的命名以小写字符“btn”开头+按钮所代表含意的英文单词，每个英文单词的首字母需大写。
为了使用各类界面中的按钮有灵活的设置，将对界面中的按钮进行分类，从而引用不同的CssClass。
其中：
单据新增界面中工具栏中的按钮将统一引用CssClass：
ToolbarNew，从而保证修改此CssClass时，只改变所有具有此工具栏的界面。
单据的主界面中工具栏中的按钮将统一引用CssClass：
ToolbarMain，从而保证修改此CssClass时，只改变所有具有此工具栏的界面。
其它网页界面中的功能按钮中，所有两个字的按钮将引用相同的CssClass：
Button；
所有四个字的按钮将引用相同的CssClass：
Button4。
✓对于WindowsForm页面
对于WindowsForm中的按钮的命名以小写字符“cmd”开头+按钮所代表含意的英文单词，每个英文单词的首字母需大写；
1.3.2.输入、选择控件命名规范
控件类型
控件名前缀
控件名
引用CssClass
备注
Label
lbl
数据库字段名
TextBox
txt
TextArea
多行的TextBox
RadioButton
rdo
RadioButtonList
rdolst
CheckBox
chk
CheckBoxList
chklst
ListBox
lst
ListBoxList
lstlst
DropDownList
drp
以上规范适合于Web页面及WindowsForm页面。
1.3.3.DataGrid网格控件命名规范
为了便于在程序开发中对网格控件的控制，一个界面中网格控件名称为统一为datagrid1，如果此界面中有多个控件，可分别命名为datagrid2、datagrid3……datagridn。
对于WebDataGrid控件的CSS引用规范如下：
网格元素
说明
对应的DataGrid项
网格本身
Tabel
设置网格本身的样式
DataGrid或客户端Tabel
DataGrid交替项
TabelAltern
DataGrid交替项的样式
AlternationItemStyle
DataGrid标头项
TabelHead
DataGrid标头的样式
HeaderStyle
DataGrid普通项
TabelItem
DataGrid普通项的样式
ItemStyle
DataGrid脚注项
TabelFoot
DataGrid脚注的样式
FooterStyle
DataGrid编辑项
TabelEdit
DataGrid编辑项的样式
EditItemStyle
DataGrid选定项
TabelSelect
DataGrid选定项的样式
SelectedItemStyle
DataGrid分页项
TabelPage
DataGrid分页项的样式
PagerStyle
每个DataGrid在设置时，必须设置以上的CssClass项及相应的控件名称。
1.3.4.工具条控件命名规范
GroupID
Caption
按钮ID
ToolTipText
tbrNew
tbrSave
tbrDelete
导入
tbrImport
数据导入
导出
tbrExport
数据导出
tbrPrint
预览
tbrPreview
打印预览
插行
tbrInsertRow
插入行
删行
tbrRemoveRow
删除行
审核
tbrCheck
反审
tbrUnCheck
取消审核
查看
tbrView
查看资料卡片
查找
tbrBlur
模糊查找
退出
tbrExit
1.4.菜单及菜单项命名规范
Menu_Level
Menu_Caption
Menu_Name
Menu_ShortCut
Description
文件（&
F）
mnuFile
1-1
新建（&
N）
mnuFileNew
Ctrl+N
新增一张单据
1-2
保存（&
S）
mnuFileSave
Ctrl+S
保存单据信息
1-3
删除（&
D）
mnuFileDelete
Ctrl+D
删除当前单据
1-4
清空（&
C）
mnuFileClear
Alt+Bksp
清空当前单据的信息
间隔
MnuFileSp2
1-5
数据导入（&
I）…
MnuFileImport
Ctrl+I
使用模板
1-6
数据导出（&
E）...
mnuFileExport
Ctrl+E
保存当前单据为模板
MnuFileSp3
1_7
打印（&
P）…
mnuFilePrint
Ctrl+P
打印当前数据
1_8
打印预览（&
V）
mnuFilePreview
预览当前数据
1_9
退出（&
Q）
MnuFileQuit
Ctrl+Q
退出当前的操作
编辑（&
E）
MnuEdit
2-1
插入行（&
I）
mnuEditInsertRow
Shift+Ins
在当前位置插入明细行
2-2
删除行（&
R）
mnuEditRemoveRow
Shift+Del
删除当前的明细行
MnuEditSp1
2-3
清空网格
mnuEditClearGrid
如果状态条上用到以ClearGrid命名,否则与清除界面时冲突
MnuEditSp3
2-4
剪切行（&
T）
mnuEditCut
Ctrl+X
2-5
复制行（&
mnuEditCopy
Ctrl+C
2-6
粘贴行（&
P）
mnuEditPaste
操作&
O）
MnuOperate
3_1
审核（&
mnuOperateCheck
3_2
取消审核（&
U）
mnuOperateUnCheck
3-3
查看消息（&
V）…
mnuOperateViewMessage
F6
3-4
发送消息（&
S）…
mnuOperateSendMessage
F7
查看（&
MnuView
4-1
资料卡片（&
mnuViewCard
F5
查看各种资料的卡片
4-2
模糊查找（&
B）
mnuViewBlur
F2
MnuViewSp2
4_3
刷新（&
MnuViewRefresh
F9
刷新查询的数据
帮助（&
H）
MnuHelp
F1
5_1
内容（&
C）…
mnuHelpContent
5_2
索引（&
mnuHelpIndex
mnuHelpSp1
5_3
公司主页（&
W）
mnuHelpWeb
mnuHelpSp2
5_4
关于（&
A）…
mnuHelpAbout
特殊单据、特殊窗体菜单定义
显示/隐含列（&
MnuViewHideCol
设置当前网格格式（显示/隐藏列）
排序（&
MnuViewSort
升序（&
A）
mnuViewAsc
降序（&
mnuViewDesc
全部选定（&
mnuViewAll
反向选择（&
mnuViewReserve
向导（&
W）…
mnuOperateWizards
2.程序编码规范
2.1.代码格式
◆所有的缩进为4个空格，不允许保留制表符，因为不同的编辑器制表符的长度不一样。
◆在代码中垂直对齐左括号和右括号。
if（x==0）
{
Response.Write（"
用户编号必须输入！
"
）;
}
不允许以下情况：
if（x==0）{
或者：
if（x==0）{Response.Write（"
}
◆代码行的最大长度。
为了防止在阅读代码时不得不滚动源代码编辑器，每行代码在1024*800的显示频率下不得超过一显示屏（136个英文字符）。
如果包括注释在内不得超过1.5显示屏的长度（176个英文字符）。
◆当一行被分为几行时，通过将串联运算符放在每一行的末尾而不是开头，清楚地表示没有后面的行是不完整的。
stringmStrSql="
INSERTINTOPAS_CM_RewardPunlish（RPLevelDetail,RPType,“+
“UserGUID,RPID,Memo,RPReason,RPDate,Status,AddIP,“+
“RPType,UserGUID,RPID,Memo,RPReason,RPDate,Status,AddIP"
;
◆编写SQL语句时，对于关键字使用全部大写；
对于数据库元素（如表、列和视图）使用大小写混合。
◆将大的复杂代码节分为较小的、易于理解的模块。
为了便于代码的阅读及维护，规定每个方法、函数的代码最长不得超过100行。
最好每个方法的代码行数遵循不超过30行的原则，如果可以拆分的方法尽量多拆分。
这样利于系统的维护，也减少了bug的出现概率。
2.2.接口、类、方法、属性命名规范
2.2.1.接口及接口成员的命名规范
◆接口的命名规范如下：
Ø
给接口名称加上字母I前缀，以指示该类型为接口。
用名词或名词短语，或者描述行为的形容词命名接口。
例如，接口名称IComponent使用描述性名词。
接口名称ICustomAttributeProvider使用名词短语。
名称IPersistable使用形容词。
各英文单词或缩写单词的首字母必须大写。
接口中使用的英文单词数不得超过三个英文单词。
使用Pascal大小写。
少用缩写。
在定义类/接口对（其中类是接口的标准实现）时使用相似的名称。
两个名称的区别应该只是接口名称上有字母I前缀。
使用要编写Employee类的接口，则其接口为Iemployee。
这样在编码时就能很容易的辨认出某类的接口及某接口对应的类。
不要使用下划线字符_。
◆接口方法的命名：
接口方法的名称=代表接口功能的动词或由代表接口功能的动词+代表接口操作对象的名称组成。
其中，动词由一个英文单词组成。
一般不允许使用英文的缩写。
操作对象的名称由一个或三个以下（包括三个）英文单词或英文单词缩写组成。
每个英文单词或缩写单词的首字母应大写。
得到用户名的接口方法：
GetUserName
更改用户口令的接口方法：
ChangePassword
用户管理接口IEmployee增
升级会员 