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