文档介绍:计算机源代码编写规范(VB编码规范)
编号:MPDK/ZY-17-2007
修改号:0
发放号:
发布时间:2007-06-28
实施时间:2007-06-28
编制:
批准:
VB编码规范
VB编码规范 1
1 目的 1
2 适用范围 1
3 规范内容 2
最低限制的编程规约 2
对象的命名基准 2
控件的前缀 2
数据访问对象(DAO,ADO)的前缀 3
菜单的前缀 4
其他控件前缀的选择 4
常量和变量的命名基准 5
变量的有效范围 5
变量有效范围的前缀 5
常量 6
变量 6
变量的数据类型 6
说明变量和过程用途的名字 7
用户自定义类型 7
代码编写规约 7
代码注释规约 7
代码的形式 8
常量的分组化 9
& 运算符和+ 运算符 9
MsgBox、InputBox、以及 SQL 查询字符串的作成 9
目的
规范ASP代码编写人员的编程工作。
适用范围
本规约是科大量星的基本编程规约,用于Visual Basic编程。
编程规约不是程序的逻辑,而是作为统一程序的物理结构和外观的基准规约。编码是如果遵守编程规约,那么代码的阅读理解和维护都将会变成一种乐趣。编程规约的内容如下:
工程,变量以及过程的命名基准
代码的惯用标签和注释的标准形式
间隔,记述形式以及缩进
编程规约设定的理由是,如果一贯使用某种编程规约,应用程序的风格和结构都是标准化的,代码将很容易理解和维护。
规范内容
最低限制的编程规约
作为通用的编程规约,规定最低限制的必要条件。为实现这个目标,同时也是为了程序,程序的逻辑以及车工序的流程能自由的做成。
该规约推荐的基准是一个简单的参考,没有提供对全部的对象和控件的规定。另外也没有规定注释的全部类型。对应于工程和组织的各自要求条件,添加以下的要素作为基准:
公司内部开发的或由第三方处购入的特殊对象和控件的命名基准
表示组织的事业内容和设施的变量名
对于工程和公司,容易理解和容易阅读作为一个重要的要素考虑
赋予对象具有一个一惯性使用的前缀的名字,对于方便容易的理解对象的种类是必要的。在这里推荐控件,数据访问对象和菜单的命名基准。
对于常量和变量的命名基准,列举Visual Basic支持的常量和变量的命名基准推荐例子。另外,也说明一下数据类型和适用范围的识别。
对象的命名基准
如果一惯性的赋予对象名某个前缀,识别对象的种类就会很容易。下表中是Visual Basic支持的部分对象命名推荐基准一览。
控件的前缀
控件种类
前缀
例
Check Box
chk
chkReadOnly
Combo Box
cbo
cboEnglish
Radio Box
rdo
rdoEnglish
按钮
cmd
cmdExit
对话框
dlg
dlgFileOpen
数据控件
dat
datBiblio
bo
dbcbo
dbcboLanguage
DB Grid
dbgrd
dbgrdQu