网络编程
位置:首页>> 网络编程>> Asp编程>> 学ASP应该注意ASP程序书写的规范标准(2)

学ASP应该注意ASP程序书写的规范标准(2)

 来源:jzxue.com 发布时间:2008-10-17 10:16:00 

标签:规范,标准,asp

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类型的变量

3.3.2. 变量类型

虽然在ASP中不须要声明变量类型,它只有一个Variant型。但为了方便源程序的阅读,我们决定为变量加上类型描述前缀。对于一些特定类型可采用一定的简写如下:
变量类型. 简写
整型(Integer). i
短整型(Short Integer). sh
长整型(Long Integer). l
单精度型(Single). sn
双精度型(Double). db
字节型(Byte). by
字符型(Char). c
字符串型(String). s
二进制型(Binary). bn
布尔型(Boolean). b
日期时间型(DateTime). d
数组型(Array).  a
象型(Object). o
循环控制变量通常使用单一的字符如:i, j, k。 另外使用一个有意义的名字,如iUserIndex ,也是准许的。

3.3.3. 全局变量(Global Variables)

尽量不使用全局变量,如必须使用全局变量则必须加前缀‘gbl_',同时应在变量名称中体现变量的类型。

3.3.4. 类级变量(Class Variables)

类级变量主要是指在Class中,对整个Class内部所有的属性和方法都起作用的变量。在使用时必须加前缀’cls_’,同时在变量名称中体现变量的类型。
  例如:cls_iFileName

3.4. 类(Class)

类的名字必须有意义并且名字之前要加前缀‘T'。例如:


Class TUpload

End Class

类实例的名字通常是去掉‘T'。例如:

Dim oUpload : oUpload=new TUpload

3.5. 表单(Form)

3.5.1. 命名标准

表单及表单项命名应该有意义,并且使用类型简写作为前缀。类型及简写如下表:
类型. 简写
表单(Form). frm
文本框(TextBox,包括密码框和多行文本框). txt
复选框(CheckBox). chk
单选框(Radio). rdo
按钮(Button). btn
下拉框(Select). slt

3.6. 文件

3.6.1. 目录结构
  程序主目录--Web(应用程序所在路径)
  -DB(本地数据库所在路径)
  -Doc(文档所在路径)
  -Help(帮助文件所在路径)
  -Backup(备份路径)
  -Temp(临时文件路径)

3.6.2. 文件命名
   文件必须使用一个有意义的名字。例如:系统中一个录入用户资料表单的文件名为frmAddUser.asp,向数据库中录入用户资料的文件名为addUser.asp。

3.6.3. 文件头
  在所有文件的头部应写上此文件的用途,作者,最后修改日期、用途。例如:

‘/**
‘*@ 作者:cjj
‘*@ 用途:上传文件
‘*@ 创建日期:2006-11-29
‘*@ 修改历史:
‘* cjj(修改人) 修改于 2006-11-30(修改日期) 为了解决…..(修改说明)。
‘* zs 修改于 2007-1-1 为了解决….
‘……..
‘*/

0
投稿

猜你喜欢

手机版 网络编程 asp之家 www.aspxhome.com