学ASP应该注意ASP程序书写的规范

1       规范简介
本规范主要规定ASP源程序在书写过程中所应遵循的规则及注意事项。编写该规范的目的是使项目开发人员的源代码书写习惯保持一致。这样做可以使每一个组员都可以理解其它组员的代码，以便于源代码的二次开发记忆系统的维护。
2       一般格式规范
2.1       缩进
缩进就是在当源程序的级改变时为增加可读性而露出的两个空格。缩进的规则为每一级缩进四个空格。不准许使用Tab。因为Tab会因为用户所作的设置不同而产生不同的效果(如果习惯使用空格的话，可以在编辑器中设置将Tab换成四个空格)。当进入判断(If…Then、Select…End Select)、循环(For[ Each]…Next、While…Loop)、With语句、函数、过程、类声明的时侯增加一级， 当遇到退出判断、循环、with语句、函数、过程、类的时侯减少一级。例如：

iTemp=0

If (iTemp<> 100) Then
    iTemp = 100
End If

2.2       换行
换行就是在判断、循环、With语句的起始与结束时各加入一个换行。函数、过程、类的声明结束时，加入一个。换行是为了程序方便调试，可读性更强。
例1：

i=0

Do While (i<10)
    i = i + 1
Loop

Response.Write(i & “<br/>”)

例2：

Class class1
…..
End Class

Class class2
….
End Class

例3：

Function fun1()
….
End Function

Sub sub1()
….
End Sub

2.3       空格
在操作符及逻辑判断符号的两端添加空格，例如：

i = i + 1
a = a And b
sHTML = ”abc” & sHTML

但添加括号时不需要空格。例如：

If ( a > b ) Then ’错误的用法
If (a > b) Then ‘正确的用法

3       VBScript语法书写格式规范
3.1       保留字
　　VBScript语言的保留字或关键词应全部使用第一个字母大写,其余字母小写的原则。另外也可采用全部小写的方式，主要为了方便输入源程序。
3.2       过程和函数
3.2.1       命名及格式
过程和函数的名称应全部使用有意义的英文单词组成，并且第一个单词全部小写，其它单词的第一个字母使用大写字母。如果只有一个单词，则第一个字母大写。例如：

Sub formatharddisk() ’不正确的命名
Sub formatHardDisk ‘正确的命名
Sub show() ‘不正确的命名
Sub Show() ‘正确的命名

设置变量内容的过程和函数，应使用set作为前缀，例如：

Sub setUserName

读取变量内容的过程和函数，应使用get作为前缀，例如：

Function getUserName

3.2.2       过程和函数的参数
首先所有参数名称必须是有意义的。参数命名采用同义的英文，可使用几个英文单词，但每一个单词的首字母必须大写。先说明参数的引用类型，如ByVal或ByRef。参数名前加前缀‘a_',后跟参数的类型(参见变量类型中的书写规范)，必须小写，最后跟参数名，单词的第一个字母大写。例如：

Sub someProc(ByVal a_sUserName, ByVal a_iUserAge)

3.3       变量
3.3.1       变量命名及格式
首先所有变量必须起有意义的名字，使其它组员可以很容易读懂变量所代表的意义，变量命名采用同义的英文命名，可使用几个英文单词，但每一单词的首字母必须大写。另外还需在变量名中体现变量类型。例如：

Dim sWriteFormat ‘s表示String类型的变量

评论总数：1 条 [ 查看全部 ] 网友评论