ＶＢ编码细则文件文件

1、NETS编码规则株式会社东芝（注）：页开始是英文文资料。NOTE :The prvious page is the Japanese Documentations . The English ones Starts from this page .资料号码：. TOC o 1-3 第 1 章 序言 PAGEREF _Toc452968675 h 4第 2 章 编码的预备 PAGEREF _Toc452968676 h 5第 3章 命名规约 PAGEREF _Toc452968677 h 63 1 . 使用的目的 PAGEREF _Toc452968678 h 63 2 . Object的结构化

2、 PAGEREF _Toc452968679 h 733. 前缀（prefix） PAGEREF _Toc452968680 h 83 4 . 标签（tag） PAGEREF _Toc452968681 h 93 5 . 差不多名（BaseName） PAGEREF _Toc452968682 h 103 6 . 量词（ Qualifier） PAGEREF _Toc452968683 h 113 7 . 后缀（Suffix） PAGEREF _Toc452968684 h 12第章模块头 PAGEREF _Toc452968685 h 134 1 . 外部模块头 PAGEREF _Toc45

3、2968686 h 134 2 . 内部模块头 PAGEREF _Toc452968687 h 154 3 . 注释语句 PAGEREF _Toc452968688 h 17第 5章 错误处理 PAGEREF _Toc452968689 h 195 1 . 结构化错误处理 PAGEREF _Toc452968690 h 195 2 . Inline错误处理 PAGEREF _Toc452968691 h 19第 6章 编码规约 PAGEREF _Toc452968692 h 206 1 . 函数化 PAGEREF _Toc452968693 h 206 2 . 常数的使用 PAGEREF _T

4、oc452968694 h 206 3 . 变量的声明 PAGEREF _Toc452968695 h 206 3 1 . 变量生明 PAGEREF _Toc452968696 h 206 3 2 . 变量的范围 PAGEREF _Toc452968697 h 226 4 . 函数的声明 PAGEREF _Toc452968698 h 226 4 1.SUB PAGEREF _Toc452968699 h 226 4 2 . FUNC PAGEREF _Toc452968700 h 226 5 . 操纵语句 PAGEREF _Toc452968701 h 226 5 1 . I FENDIF

5、PAGEREF _Toc452968702 h 225 5 2. FORNEXT PAGEREF _Toc452968703 h 245 5 3.SELECTCASE PAGEREF _Toc452968704 h 255 5 4.DO LOOP PAGEREF _Toc452968705 h 27第 7 章 控件 PAGEREF _Toc452968706 h 28第章用户控件 PAGEREF _Toc452968707 h 29.在用户控件上作成规定属性 PAGEREF _Toc452968708 h 298 2 . 在用户控件中作成规定Event PAGEREF _Toc45296870

6、9 h 30第章数据库访问规则 PAGEREF _Toc452968710 h 31开发环境 PAGEREF _Toc452968711 h 31连接断开 PAGEREF _Toc452968712 h 31表示检索的结果 PAGEREF _Toc452968713 h 33第 1 章 序言所谓编码确实是基于在程序设计时作成的程序设计书和流程图等逻辑设计、用编程语言、对为在计算机上实现某些功能的逻辑进行描述的工作。在编码过程中、为了消除因程序员水平不同而造成的差异、为了顺利的进入单体测试时期、同时也为了维护方便、以下整理了编码的预备和代码书写的标准。而且、关于书写标准、除非客户有指定的要求、或

7、者使用了（半）自动生成代码的工具话、则应尽量遵从那个标准。本规范是以使用Microsoft 的 Visual Basic 来开发PC的应用程序为前提的。第 2 章 编码的预备以系统设计书、程序设计书（依照情况也包含流程图等的逻辑设计书）为基础。在完全理解了以上文档内容的基础上开始编码工作（特不是程序设计书的作者和编码的担当者不同时）。关于不明白的地点不要随意推断、要进行确认。始终注意要把程序的易理解性（易读性）放在第一位。为此、在编程时要时刻想着程序的读者、本着以向读者讲明的态度来编写程序是写好程序的关键。读起来容易理解的程序一般来讲总是质量优良、而且容易改造的。象数据库的记录的规范等incl

8、ude文件、模块头、宏定义等系统应该统一的东西、要采纳系统规定的东西、不要依照个人的意愿随意的作成、否则、这将成为在进行变更和改造时发生问题的缘故。编码结束后、要对代码进行检查。不检查代码则不能轻易的进入下一步的测试时期的工作。检查代码不仅是最容易发觉错误的方法、而且有时还能检出在测试时不易发觉的复杂错误。第 3章 命名规约3 1 . 使用的目的命名规约以以下4点为目的的而使用。Object名容易明白会使应用程序的结构代码等容易理解。确立开发小组“通用语言”、使全体成员用同样的“语言”来开发应用程序。使VB Jet的Object 容易被使用。用较少的劳力作成VB开发用的工具、在各式各样的VBA

9、 平台里通用的源码库。本规约是用遵从被VisualBasic作为标准的 Lezynski命名规则（Lezynski Naming Convention、 以下称LNC）的方法来规定命名法的。3 2 . Object的结构化LNC按以下格式对Object进行命名。 Prefix tag BaseName Quantifier Suffix Prefix前缀Tag标签BaseName差不多名Quantifier量词Suffix后缀对各个部分按顺序进行讲明。. 前缀（prefix）前缀是在标签前面的识不符、是对标签进行进一步详细讲明的。前缀用1到2个小写字母组成。对1个Object复数个前缀能够组合

10、使用。前缀有表示有效范围的和表示变量特性的。另外、2个前缀能够重叠使用。表示有效范围的前缀表1 . 表示有效范围的前缀无Procedure内的局部变量s用Static声明的Procedure的局部变量m在模块Declarations Section 的用Dim 或Private声明的模块水平的变量p在模块的Declarations Section用Public声明的变量g在模块的Declarations Section作为Public或Global声明的变量表示变量特性的前缀表2. 表示变量特性的前缀a作为数组声明的变量c用Const声明的变量e作为的Collection1个要素的变量i作为数

11、组的Index或循环的计数器使用的变量r传递给Procedure参数的作为参照传递( ByRef )声明的变量t作为用户定义型定义的变量v传递给Procedure参数的作为值传递( ByVal )声明的变量例值传递的参数：vintCount参照传递的参数： rstrFileName在Declarations用public声明的数组的Index变量：apintMember用Const声明的变量：cintFNAMEMAX3 4 . 标签（tag）标签是表示差不多名的特征的复数个的字母、放在差不多名的前面。标签差不多上相当于面向Object编程的类识不符。标签用3到4个小写字母组成。标签是表示差不多

12、名的特征的复数个的字母、表示变量的型啦的种类。从标签表示的意思上能够对数据型、模块、Form、控件的标签进行分类。数据型表3. 数据型标签布尔值bln长整数lngBytebytObjectobj双精度浮点数dbl字符串str错误err用户定义typ整数intVariantvar模块、Form、控件表4 模块标签 表5. 标签类模块cls对话框fdlg标准模块bas菜单fmnuFormfrm表6. 控件标签Command ButtoncmdOption Buttonopt控件ctlPocturepic,picsCombo BoxcboPrinterprn,prns菜单mnu属性prp,prps菜

13、单项mni,mnisTabtab,tabsNodenod,modsText BoxtxtList BoxlstCommon Dialogcdlg例判定成功用的变量：blnSuccess文件名：strFileName检索处理用的标准模块：basSearchData主Form：frmMainStart Button：cmdStartFont Dialog：cdlgFont3 5 . 差不多名（BaseName）差不多名是设Object名是最先遇到的部分、是不管采纳不采纳命名规则都必须使用的名字。差不多名要用有意义的单词（原则上用英文单词）来组合、各个单词的第一个字母大写其余用小写。这时、再加上专用

14、名词的情况下、要用日语的罗马字。然而、用Const声明的变量的差不多名全部用大写。另外、尽管没有限制、差不多名依旧要选择不太长的名字。作为差不多名的样本用在VB编码里的标准的作业变量表示如下。表7 . 标准LNC作业变量blnRET同意函数调用的返回值（ True/False ）intErr保持Err的值intLoop循环计数器intMsg同意MsgBox函数的返回值intResult保持算术演算的接果（dblresult 、lngResult 也同样）intRet同意函数调用的返回值（dblRet、lngRet也同样）intWord用在所有临时的作业（dblWord 、 lngWork也同样

15、）strMsg作成Message Box字符串3 6 . 量词（ Qualifier）量词表示Object在关联上是如何样被利用的。（最大、最小等）量词要尽量短、用大写.小写字母的组合来表示。表8 . 量词Curr存贮1Set内的现在的要素First存贮1Set内的最初的要素Hold存贮以后要使用的要素Last存贮1Set内的最后的要素Max存贮1Set内的最大要素Min存贮1Set内的最小要素Next存贮1Set内的下一个的要素New存贮的新的instance或值Oid存贮的往常的instance或值Prev存贮1Set内的前面的要素Src存贮SourceTemp存贮临时的值3 7 . 后缀

16、（Suffix）后缀是以在按照命名规则时变成的名字的Object名上识不符为目的而添加的。因此不是非要不可、依照Project决定是否采纳。假设DB关联的标准模块有SortData、DeleteData、InsertData、UpdateData4个。这时、假如存贮错误码的变量设为、在各个模块里确保变量的话、就会区不不开。假如在取各个模块的大写的2个字母作后缀、各个变量就能区不开。SortData（ SD ）-gintErr_SDDeleteData（ DD ）-gintErr_DDDeleteData（ ID ）-gintErr_IDDeleteData（ UD ）-gintErr_UD尽管

17、后缀的决定方法没有特不的基准、依旧要选择容易明白区不基准的2到3个字母的字符串。另外、大写字母、小写字母能够任意使用。第章模块头 模块头对了解模块的概要是专门有效的、另外还有助于维护。因此、对此必须记述。4 1 . 外部模块头外部模块头要记述以下项目。（有关程序全体的信息在Include文件（文件名=程序名.h）记述。）（ a ）模块识不信息系统名客户名程序名或模块名担当部科名著作权表示（ b ） 模块讲明功能参数讲明动作环境/作成环境作成担当着名（ c ） 履历作成日时（单体试验完成日）变更日时变更内容版本信息（ d ）补充讲明 外部模块头*Copyright Shenyang NETS S

18、ystem Integration Co. Ltd.1998.All Rights Reserved.系统名 ：系统名客户 ：客户 程序 ：程序名称担当部长 ：沈阳东东系统集成有限公司 开发一部*功能 ：功能概要参数 ：对有关重要参数进行讲明作成环境 ：工具、编译环境、OS动作环境 ：OS、制约条件担当 ：担当者名作成日 ：1999年5月28日 （Ver.0）*变更履历 Ver.0.1 1999年5月28日 所属 担当者名 变更理由 变更内容Ver.1.0 1999年6月15日 所属 担当者名 变更理由 变更内容*/4 2 . 内部模块头在内部模块头写下以下项目。 （ a ）模块讲明功能参数讲

19、明动作环境/作成环境作成担当者名 （ b ）履历作成日时（单体试验完成日）变更日时变更内容版本信息（c ）补充讲明 内部模块头*功能 ：功能概要参数 ：对有关参数进行讲明担当 ：担当者名作成日 ：1999年5月28日（Ver .0）*变更履历Ver .0 1999年5月31日 所属 担当者名 变更理由. 变更内容Ver .0 1999年6月15日 所属 担当者名 变更理由. 变更内容*4 3 . 注释语句考虑到提高维护性、以模块及块为单位写上内容讲明、以便立即能找到修改的地点。为了关心读者理解程序、在不容易理解的逻辑上加上讲明。不是在只读了程序立即就能理解的地点加上注释、而是要象给读者提供新信

20、息之类的讲明。例如、写上在那儿使用的算法的注释。不要加上不必要的注释。在注释之前、先要在识不符命名法、整理程序构造上下工夫使程序容易被读明白。注释语句尽可能写的简单明了.注释写在语句的前面时要和语句的列对齐。 注释 XXXX YYYY把源码删除、改成注释时、不要用不容易弄清范围是否有效的写法。 Ver0.5 删除 start XXXXX； YYYYY； Ver0.5 删除 end变更 修改程序时对注释也必须进行维护。第 5章 错误处理错误处理有“结构化错误处理”和“Inline错误处理”2种方法。现在的主流尽管是“结构化错误处理”、依照系统也能够使用“Inline错误处理”。另外、也能够把两个

21、组合起来使用。然而、必须对所有的错误的发生都执行错误处理来进行编码。5 1 . 结构化错误处理结构化错误处理是以“On Error Goto XXXX”的语句来记述、在XXXX的部分记述错误处理的方法。这时、错误处理程序XXXX原则上写在Procedure的最后、XXXX要设成、“错误名”+“Err”的名字。5 2 . Inline错误处理Inline错误处理是在错误发生后立即Trap错误的编码方法。为了实行那个、实施以下2点。在Procedure的开始处写上“On Error Resume Next”语句在有可能发生错误的码的紧后面编进确认逻辑。第 6章 编码规约6 1 . 函数化 在符合以

22、下条件的情况下、要把处理汇总成子成序。 2个地点以上被使用的处理超过100步的处理独自作成的函数要写在BAS文件里。这时、BAS文件的最大步数不要超过500步。关于被2个以上可执行文件使用的函数、共享包含那个函数的BAS文件。6 2 . 常数的使用关于字符串的尺寸、上限值、下限值等预先定下来的值、要把那个作为文字常数来定义并使用此常数。6 3 . 变量的声明 6 3 1 . 变量声明（ 1 ）“Option Explicit”生明Option Explicit”声明使声明所有的变量在参照前必须进行声明的声明。在作成新模块时、必须进行那个声明。或在环境中设置。（ 2 ） “Dim”声明Dim”声

23、明是为了声明变量并分配存贮领域而使用。因为声明因生明的地点不同而使范围不同、因此假如希望范围明确的话、用“Public”、“Private”声明进行声明。用“Dim”声明进行变量声明时、必须把变量的型用“As Type ”来声明这时、在进行复数个变量声明的情况下、要给各个变量加上“As Type”。例）Dim strName As String , strFile As String ,strData As String 这种情况下、String型的str Name str File, str Data 3个变量被生明。Dim strName , strFile ,strData As Str

24、ing 这种情况下、Variant型的s z Name 、s z File 和String 型的s z Data 变量被声明。 （ 3 ）“Public 、Private”声明这些声明是在对水平的变量进行声明时使用。“Public”是对Project内通用的变量、“Private”是只对模块内使用的变量使用。（ 4 ）“Static” 声明在对Procedure水平的变量进行声明时使用。用“Static”声明的变量在程序执行期间内成为有效的变量。（ 5 ）“Const”声明 Procedure模块两方多可使用。用“Const”声明的变量不能变更。用“Public” “ Static” “ Co

25、nst”声明的变量要预先记载在设计书上。另外、尽可能地把这些变量汇总在1个标准模块上声明。6 3 2 . 变量的范围变量由于声明的地点和声明的种类不同有效范围会有所不同、因此要在考虑范围后再对变量进行声明。6 4 . 函数及子程序的声明函数的声明参数“ByRef” “ByVal”的声明必须进行。读入在DLL定义的函数时、要对被DLL Export的函数名确认后在进行声明。用Alias变更函数名时、要用容易明白原来的函数名的名字。6 4 1.SUB调用子程序时、有用和不用Call调用的方法、在系统中要统一。6 4 2 . FUNC 声明函数时、要用As Type的形式对返回值进行声明。6 5 .

26、 操纵语句6 5 1 . I FENDIF有关条件比较、必须考虑进ELSE进行记述。原则上要用确信型条件比较。进行变量比较时、原则上不使用奇妙数用全局变量或常数进行比较。例） if nCount = MAX-COUNT then nPage = nPage + 1 endif if nCount = 10 then nPage = nPage + 1 endif5 5 2. FORNEXT把循环变量写在 NEXT 的后面使循环的范围容易明白例） For nLoop = 1 to 100 nPage = nPage + 1 NEXT nLoop For nLoop = 1 to 100 nPage = nPage + 1 NEXT 5 5 3.SELECTCASE关于语句的各个值的意义要写上注释。另外、考虑到取得预期以外的值的情况要加进CA