|
1 规范简介 本规范主要规定ASP源程序在书写过程中所应遵循的规则及注意事项。编写该规范的目的是使项目开发人员的源代码书写习惯保持一致。这样做可以使每一个组员都可以理解其它组员的代码,以便于源代码的二次开发记忆系统的维护。 2 一般格式规范 2.1 缩进 缩进就是在当源程序的级改变时为增加可读性而露出的两个空格。缩进的规则为每一级缩进四个空格。不准许使用Tab。因为Tab会因为用户所作的设置不同而产生不同的效果(如果习惯使用空格的话,可以在编辑器中设置将Tab换成四个空格)。当进入判断(If…Then、Select…End Select)、循环(For[ Each]…Next、While…Loop)、With语句、函数、过程、类声明的时侯增加一级, 当遇到退出判断、循环、with语句、函数、过程、类的时侯减少一级。例如: CODE: iTemp=0 If (iTemp<> 100) Then iTemp = 100 End If 2.2 换行 换行就是在判断、循环、With语句的起始与结束时各加入一个换行。函数、过程、类的声明结束时,加入一个。换行是为了程序方便调试,可读性更强。 例1:
CODE: i=0 Do While (i<10) i = i + 1 Loop Response.Write(i & “<br/>”) 例2:
CODE: Class class1 ….. End Class Class class2 …. End Class 例3:
CODE: Function fun1() …. End Function Sub sub1() …. End Sub 2.3 空格 在操作符及逻辑判断符号的两端添加空格,例如:
CODE: i = i + 1 a = a And b sHTML = ”abc” & sHTML 但添加括号时不需要空格。例如:
CODE: If ( a > b ) Then ''错误的用法 If (a > b) Then ‘正确的用法 3 VBScript语法书写格式规范 3.1 保留字 VBScript语言的保留字或关键词应全部使用第一个字母大写,其余字母小写的原则(推荐)。另外也可采用全部小写的方式,主要为了方便输入源程序。 3.2 过程和函数 3.2.1 命名及格式 过程和函数的名称应全部使用有意义的英文单词组成,并且第一个单词全部小写,其它单词的第一个字母使用大写字母。如果只有一个单词,则第一个字母大写。例如:
CODE: Sub formatharddisk() ''不正确的命名 Sub formatHardDisk ‘正确的命名 Sub show() ‘不正确的命名 Sub Show() ‘正确的命名 设置变量内容的过程和函数,应使用set作为前缀,例如:
CODE: Sub setUserName 读取变量内容的过程和函数,应使用get作为前缀,例如:
CODE: Function getUserNa me 3.2.2 过程和函数的参数 首先所有参数名称必须是有意义的。参数命名采用同义的英文,可使用几个英文单词,但每一个单词的首字母必须大写。先说明参数的引用类型,如ByVal或ByRef。参数名前加前缀‘a_'',后跟参数的类型(参见变量类型中的书写规范),必须小写,最后跟参数名,单词的第一个字母大写。例如:
CODE: Sub someProc(ByVal a_sUserName, ByVal a_iUserAge) |
|
【收藏】【打印】【进入论坛】 |
|
|
|
|
|
|
|