VB编码规范

计算机源代码编写规范(VB编码规范)编号：MPDK/ZY-17-2007修改号：0发放号：发布时间：2007-06-28实施时间：2007-06-28编制：批准：VB编码规范VB编码规范......................................................................................................................................11目的...........................................................................................................................................12适用范围.....................................................................................................................................13规范内容.....................................................................................................................................23.1最低限制的编程规约.......................................................................................................23.2对象的命名基准..............................................................................................................23.3控件的前缀....................................................................................................................23.4数据访问对象(DAO，ADO)的前缀.......................................................................................33.5菜单的前缀....................................................................................................................43.6其他控件前缀的选择.......................................................................................................43.7常量和变量的命名基准....................................................................................................53.8变量的有效范围..............................................................................................................53.9变量有效范围的前缀.......................................................................................................53.10常量..............................................................................................................................63.11变量..............................................................................................................................63.12变量的数据类型..............................................................................................................63.13说明变量和过程用途的名字..............................................................................................73.14用户自定义类型..............................................................................................................73.15代码编写规约.................................................................................................................73.16代码注释规约.................................................................................................................73.17代码的形式....................................................................................................................83.18常量的分组化.................................................................................................................93.19&运算符和+运算符......................................................................................................93.20MsgBox、InputBox、以及SQL查询字符串的作成.................................................................91目的规范ASP代码编写人员的编程工作。2适用范围本规约是科大量星的基本编程规约，用于VisualBasic编程。编程规约不是程序的逻辑，而是作为统一程序的物理结构和外观的基准规约。编码是如果遵守编程规约，那么代码的阅读理解和维护都将会变成一种乐趣。编程规约的内容如下：工程，变量以及过程的命名基准代码的惯用标签和注释的标准形式间隔，记述形式以及缩进编程规约设定的理由是，如果一贯使用某种编程规约，应用程序的风格和结构都是标准化的，代码将很容易理解和维护。3规范内容3.1最低限制的编程规约作为通用的编程规约，规定最低限制的必要条件。为实现这个目标，同时也是为了程序，程序的逻辑以及车工序的流程能自由的做成。该规约推荐的基准是一个简单的参考，没有提供对全部的对象和控件的规定。另外也没有规定注释的全部类型。对应于工程和组织的各自要求条件，添加以下的要素作为基准：公司内部开发的或由第三方处购入的特殊对象和控件的命名基准表示组织的事业内容和设施的变量名对于工程和公司，容易理解和容易阅读作为一个重要的要素考虑赋予对象具有一个一惯性使用的前缀的名字，对于方便容易的理解对象的种类是必要的。在这里推荐控件，数据访问对象和菜单的命名基准。对于常量和变量的命名基准，列举VisualBasic支持的常量和变量的命名基准推荐例子。另外，也说明一下数据类型和适用范围的识别。3.2对象的命名基准如果一惯性的赋予对象名某个前缀，识别对象的种类就会很容易。下表中是VisualBasic支持的部分对象命名推荐基准一览。3.3控件的前缀控件种类前缀例CheckBoxchkchkReadOnlyComboBoxcbocboEnglishRadioBoxrdordoEnglish按钮cmdcmdExit对话框dlgdlgFileOpen数据控件datdatBiblioDBCombodbcbodbcboLanguageDBGriddbgrddbgrdQueryResultDBListdblstdblstJobTypeDirectoryListBoxdirdirSourceDriverListBoxdrvdrvTargetFileListBoxfilfilSourceFormfrmfrmEntryFlexibleGridmsgmsgClientsFramefrafraLanguage水平滚动条hsbhsbVolumeImageimgimgIconLabellbllblHelpMessageLinelinlinVerticalListBoxlstlstPolicyCodesMDISubformmdimdiNote菜单mnumnuFileOpenMSFlexibleGridmsgmsgClientsOLE容器oleoleWorksheet选项按钮optoptRedPicturepicpicVGATextBoxtxttxtLastName定时器tmrtmrAlarm表1对象命名标准3.4数据访问对象(DAO，ADO)的前缀为了识别数据访问对象，使用下表所示的前缀数据访问对象前缀例ContainerConConReportsDatabaseDbDbAccountsDBEngineDbeDbeJetDocumentDocDocSalesReportFieldFldFldAddressGroupGrpGrpFinanceIndexIdxIdxAgeParameterPrmPrmJobCodeQueryDefQryQrySalesByRegionRecordsetRecRecForecastRelationRelRelEmployeeDeptTableDefTbdTbdCustomersUserUsrUsrNewWorkspaceWspWspMine表2DAO/ADO对象命名标准例：DimdbBiblioAsDatabaseDimrecPubsInNYAsRecordset,strSQLStmtAsStringConstDB_READONLY=4'常量设定'打开数据库SetdbBiblio=OpenDatabase(Biblio.mdb)'SQL文设定strSQLStmt=SELECT*FROMPublishersWHEREState='NY''新的Recordset对象做成SetrecPubsInNY=dbBiblio.OpenRecordset(strSQLStmt,dbReadOnly)3.5菜单的前缀应用程序大多使用菜单。菜单控件的前缀是mnu。命名例子一览如下表所示菜单标题顺序菜单控件的名字[文件][打开]mnuFileOpen[文件][送信][电子邮件]mnuFileSendEmail[