vb.net 程序設(shè)計規(guī)范（1）
2024-07-10 13:07:36
供稿：網(wǎng)友
引言：kent beck 曾經(jīng)說過“我只是個更注重的程序規(guī)范的程序員而已”
目錄：
前言
說明性文件規(guī)范
過程注釋的規(guī)范
函數(shù)的注釋規(guī)范
命名規(guī)范
設(shè)計規(guī)范：
前言: 1.設(shè)計規(guī)范的重要性:理由n多, 不在多述
2. 本文適用性 :vb.net 開發(fā) asp.net 開發(fā)
注釋代碼的目標(biāo)：
1． 敘述清除]代碼的作用（是做什么，而不是怎么做）
2． 清楚說明代碼所要表達(dá)的思想和邏輯
3． 表明代碼中的重要轉(zhuǎn)折點
4． 減少代碼閱讀者在他們大腦中模擬代碼的運行
注意：注視應(yīng)該說明代碼的目的，而不要去敘述怎么完成目標(biāo)的結(jié)構(gòu)，要講清為什么要那么做，而不是怎么去做
用特殊字符標(biāo)識注釋的作者： ‘$ ‘@ 開頭的行 分別代表不同人寫的注釋代碼
一． 說明性文件規(guī)范(寫在每個.vb結(jié)尾的文件頭,說明整個文件的功能)
1.1 以’----------------------------------開始和結(jié)尾
1.2 file name: 文件名
1.3 author作者 version版本: date及完成日期:
1.4 description: 用于詳細(xì)說明此程序文件完成的主要功能，與其他模塊
或函數(shù)的接口，輸出值、取值范圍、含義及參數(shù)間的控
制、順序、獨立或依賴等關(guān)系
1.5 others: 其它內(nèi)容的說明
1.6 function list: 主要函數(shù)列表，每條記錄應(yīng)包括函數(shù)名及功能簡要說明
1.7 history: 修改歷史記錄列表，每條修改記錄應(yīng)包括修改日期、修改
者及修改內(nèi)容簡述
1. date:
author:
modification:
2．。。。。。。。。。。。
二． 過程注釋的規(guī)范
2.1 以’----------------------------------開始和結(jié)尾
2.2 description: 功能描述
2.3 parameters :參數(shù)說明
2.4 calls : 被本過程調(diào)用的函數(shù)或過程
2.5 called by: 調(diào)用本過程的函數(shù)清單
2.6 table accessed: 被訪問的表（此項僅對于牽扯到數(shù)據(jù)庫操作的程序）
2.7 table updated: 被修改的表（此項僅對于牽扯到數(shù)據(jù)庫操作的程序）
三．函數(shù)的注釋規(guī)范
3．1 function: 函數(shù)名稱
3．2 description: 函數(shù)功能、性能等的描述
3．3 calls: 被本函數(shù)調(diào)用的函數(shù)清單
3．4 called by: 調(diào)用本函數(shù)的函數(shù)清單
3．5table accessed: // 被訪問的表（此項僅對于牽扯到數(shù)據(jù)庫操作的程序）
3．6 table updated: // 被修改的表（此項僅對于牽扯到數(shù)據(jù)庫操作的程序）
3．7 parameters: // 輸入?yún)?shù)說明，包括每個參數(shù)的作
// 用、取值說明及參數(shù)間關(guān)系。
3．8 return: // 函數(shù)返回值的說明
四 命名規(guī)范
4． 1件命名規(guī)范
(1)普通控件
名稱 前綴 示例
adrotator adrt adrttopad
button btn btnsubmit
calendar cal calmeetingdates
checkbox chk chkblue
checkboxlist chkl chkfavcolors
comparevalidator valc valcvalidage
customvalidator valx valxdbcheck
datagrid dgrd dgrdtitles
datalist dlst dlsttiltles
driopdownlist drop drop
hyperlink link lnkdetails
image img imgauntbetty
imagebutton ibtn ibtnsubmit
label lbl lblresults
linkbutton lbtn
listbox lst
panel pnl
radiobutton rad
radopbuttonlist radl
rangevalidator valg
regularexpression vale
repeater rpt
requiredfieldvalidator valr
table tbl
tablecell tblc
tablerow tblr
textbox txt
validationsummary vals
xml xmlc
(2) ado.net 控件命名
connction con connorthwind(con +數(shù)據(jù)庫名稱)
command cmd cmdreturnproducts
parameter parm parmproductid
dataadapter dad dadproducts
datareader dtr dtrproducts
dataset dst dstnorthwind
datatable dtbl dtblprpducts
datarow drow drowrow98
datacolumn dcol dcolproductid
datarelation drel drelmasterdetaril
dataview dvw dvwfilteredproducts
(3)變量命名的目標(biāo)：
1． 使變量的用途明確
2． 使每個變量的數(shù)據(jù)類型和可見范圍清晰明了
3． 使代碼中的過程易于理解
4． 使程序易于調(diào)試
5． 使變量的存儲和處理更為有效
其余見vb.net 程序設(shè)計規(guī)范（2）
