rustysun同学ASP代码书写规范

ASP源程序书写规范
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 getUserName

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

CODE:
Sub someProc(ByVal a_sUserName, ByVal a_iUserAge)

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

CODE:
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'。例如:

CODE:
Class TUpload

End Class

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

CODE:
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       文件头
  在所有文件的头部应写上此文件的用途,作者,最后修改日期、用途。例如:

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

4       修改规范
  本规则所做的规定仅适用于已经纳入配置管理的程序。在这类修改中,要求保留修改前的内容、并标识出修改和新增的内容。并在文件头加入修改人、修改日期、修改说明等必要的信息。
4.1       修改历史记录
  对源文件进行经过批准的修改时,修改者应在程序文件头加入修改历史项。在以后的每一次修改时,修改者都必须在该项目中填写下列信息:
4.2       新增代码行
  新增代码行的前后应有注释行说明。

CODE:
'(* cjj(修改人) 2006-10-11(修改时间) ….(修改说明)
……'(新增代码行)
'cjj 2006-10-11 *)

4.3       删除代码行
删除代码行的前后用注释行说明。

CODE:
‘(*修改人 修改时间 修改说明
‘要删除的代码行(将要删除的语句进行注释)
‘修改人 修改时间 修改结束*)

4.4       修改代码行
修改代码行以删除代码行后在新增代码行的方式进行。

CODE:
‘(*修改人 修改时间 修改说明
‘修改前的代码行 (注释掉修改前的代码行)
修改后的代码行)
‘修改人 修改时间 修改结束*)

(0)

相关推荐

  • rustysun同学ASP代码书写规范

    ASP源程序书写规范 1       规范简介 本规范主要规定ASP源程序在书写过程中所应遵循的规则及注意事项.编写该规范的目的是使项目开发人员的源代码书写习惯保持一致.这样做可以使每一个组员都可以理解其它组员的代码,以便于源代码的二次开发记忆系统的维护. 2       一般格式规范 2.1       缩进 缩进就是在当源程序的级改变时为增加可读性而露出的两个空格.缩进的规则为每一级缩进四个空格.不准许使用Tab.因为Tab会因为用户所作的设置不同而产生不同的效果(如果习惯使用空格的话,可以

  • JavaScript常用代码书写规范的超全面总结

    一.全局命名空间污染 总是将代码包裹在一个立即的函数表达式里面,形成一个独立的模块. 不推荐 var x = 10, y = 100; console.log(window.x + ' ' + window.y); 推荐 ;(function(window){ 'use strict'; var x = 10, y = 100; console.log(window.x + ' ' + window.y); }(window)); 二.立即执行函数 在立即执行函数里面,如果有用到全局变量应该通过

  • javascript异步编程代码书写规范Promise学习笔记

    最近工作轻松了点,想起了以前总是看到的一个单词promise,于是耐心下来学习了一下. 一:Promise是什么?为什么会有这个东西? 首先说明,Promise是为了解决javascript异步编程时候代码书写的方式产生的. 随着javascript的发展,异步的场景越来越多.前端有AJAX,setTimeout等,后端Node异步更多.按照传统的做法,那么就是各种回调嵌回调.代码可以把人绕晕. 这个时候,CommonJS社区提出了一个叫做Promise/A+的规范,这个规范定义了如何书写异步代

  • C语言的语法风格与代码书写规范指南

    C代码: #include <stdio.h> int main(void) { printf("That is Right Style\n"); return 0; } 在一个标准的C语言程序中,最特殊的莫过于main函数了,而说到底它就是一个函数而已,仅仅因为它地位特殊拥有第一执行权力,换句话说,难道因为一个人是省长它就不是人类了?所以函数该有的它都应该有,那么函数还有什么呢? 函数大体上分为内联函数(C99)(内联函数并非C++专属,C语言亦有,具体见前方链接)和非内

  • JAVA代码书写规范汇总详解

    一般原则 尽量使用完整的英文描述符 采用适用于相关领域的术语 采用大小写混合增强可读性 尽量少用缩写,但如果用了,要明智地使用,且在整个工程中统一 避免使用长的名字 避免使用类似的名字,或者仅仅是大小写不同的名字 避免使用下划线(除静态常量等) 命名的字母大小写问题 包名: 字母全小写 例如: cn.coderstory.Activity.Main 类,接口 :首字母大写,其他全小写 例如: class Container 方法,变量 :第二个单词开始首字母大写 例如: seedMessage

  • C#书写规范

    C#书写规范  一.命名  对于理解应用程序的逻辑流,命名方案是最有影响力的一种帮助.名称应该说明"什么"而不是"如何".通过避免使用公开基础实现(它们会发生改变)的名称,可以保留简化复杂性的抽象层.例如,可以使用 GetNextStudent(),而不是 GetNextArrayElement().  命名原则是:  选择正确名称时的困难可能表明需要进一步分析或定义项的目的.使名称足够长以便有一定的意义,并且足够短以避免冗长.唯一名称在编程上仅用于将各项区分开.表

  • ASP vbs 代码大小写规范

    ASP vbs 代码大小写规范-我们 function aspvbs() { var ss=document.getElementById("aspvbs").value; var vbs0="函数关键字|Function|Sub|"; var vbs1="保留关键字|And|As|ByRef|Call|Case|Class|Const|Dim|Do|Each|Else|ElseIf|Empty|End|Eqv|Erase|Execute|ExecuteG

  • J2EE项目代码编写规范分享

    码编写规范目的:能够在编码过程中实现规范化,为以后的程序开发中养成良好的行为习惯. 代码编写规范使用范围:J2EE项目开发. 包命名规范: 目的:包的命名规范应当体现出项目资源良好的划分 servlet类所在包命名规范:公司名称.开发组名称.项目名称.web.servlet 例如:net.linkcn.web.servlet 自定义标签类所在包命名规范:公司名称.开发组名称.项目名称.web.tags 例如:net.linkcn.web.tags 过滤器类所在包命名规范:公司名称.开发组名称.项

  • JAVA代码开发规范

    一.开发工具规范: 1. 开发工具经项目负责人调试后统一确定. 2. 开发工具一经确定不允许集成任何非统一插件,若有需要,经项目负责人同意后统一为 项目组成员添加. 3. 开发工具的编码格式不允许修改. 二.排版规范: 1. 关键词(或变量)和操作符之间加一个空格. 例如:int iCont = 1;//操作符和值之间有一个空格. 2. 相对独立的代码块与块之间加空行. 例如:两个方法之间需要用空格隔开. 3. 较长的语句.表达式等要分成多行书写. 4. 长表达式要在低优先级操作符处划分新行,操

  • PDP Document 代码注释规范第1/2页

    1. 什么是phpDocumentor ? PHPDocumentor是一个用PHP写的工具,对于有规范注释的php程序,它能够快速生成具有相互参照,索引等功能的API文档.老的版本是 phpdoc,从1.3.0开始,更名为phpDocumentor,新的版本加上了对php5语法的支持,同时,可以通过在客户端浏览器上操作生成文档,文档可以转换为PDF,HTML,CHM几种形式,非常的方便. PHPDocumentor工作时,会扫描指定目录下面的php源代码,扫描其中的关键字,截取需要分析的注释,

随机推荐