|
1 規(guī)范簡介 本規(guī)范主要規(guī)定ASP源程序在書寫過程中所應遵循的規(guī)則及注意事項。編寫該規(guī)范的目的是使項目開發(fā)人員的源代碼書寫習慣保持一致。這樣做可以使每一個組員都可以理解其它組員的代碼,以便于源代碼的二次開發(fā)記憶系統(tǒng)的維護。 2 一般格式規(guī)范 2.1 縮進 縮進就是在當源程序的級改變時為增加可讀性而露出的兩個空格。縮進的規(guī)則為每一級縮進四個空格。不準許使用Tab。因為Tab會因為用戶所作的設置不同而產(chǎn)生不同的效果(如果習慣使用空格的話,可以在編輯器中設置將Tab換成四個空格)。當進入判斷(If…Then、Select…End Select)、循環(huán)(For[ Each]…Next、While…Loop)、With語句、函數(shù)、過程、類聲明的時侯增加一級, 當遇到退出判斷、循環(huán)、with語句、函數(shù)、過程、類的時侯減少一級。例如: CODE: iTemp=0 If (iTemp<> 100) Then iTemp = 100 End If 2.2 換行 換行就是在判斷、循環(huán)、With語句的起始與結束時各加入一個換行。函數(shù)、過程、類的聲明結束時,加入一個。換行是為了程序方便調試,可讀性更強。 例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語法書寫格式規(guī)范 3.1 保留字 VBScript語言的保留字或關鍵詞應全部使用第一個字母大寫,其余字母小寫的原則(推薦)。另外也可采用全部小寫的方式,主要為了方便輸入源程序。 3.2 過程和函數(shù) 3.2.1 命名及格式 過程和函數(shù)的名稱應全部使用有意義的英文單詞組成,并且第一個單詞全部小寫,其它單詞的第一個字母使用大寫字母。如果只有一個單詞,則第一個字母大寫。例如:
CODE: Sub formatharddisk() ''不正確的命名 Sub formatHardDisk ‘正確的命名 Sub show() ‘不正確的命名 Sub Show() ‘正確的命名 設置變量內容的過程和函數(shù),應使用set作為前綴,例如:
CODE: Sub setUserName 讀取變量內容的過程和函數(shù),應使用get作為前綴,例如:
CODE: Function getUserNa me 3.2.2 過程和函數(shù)的參數(shù) 首先所有參數(shù)名稱必須是有意義的。參數(shù)命名采用同義的英文,可使用幾個英文單詞,但每一個單詞的首字母必須大寫。先說明參數(shù)的引用類型,如ByVal或ByRef。參數(shù)名前加前綴‘a(chǎn)_'',后跟參數(shù)的類型(參見變量類型中的書寫規(guī)范),必須小寫,最后跟參數(shù)名,單詞的第一個字母大寫。例如:
CODE: Sub someProc(ByVal a_sUserName, ByVal a_iUserAge) |
|
【收藏】【打印】【進入論壇】 |
|
|
|
|
|
|
|