VB.NET命名規(guī)范精裝篇
經(jīng)過長時間學(xué)習VB.NET,于是和大家分享一下關(guān)于VB.NET命名規(guī)范,看完本文你肯定有不少收獲,希望本文能教會你更多東西。
VB.NET命名規(guī)范方法和屬性
1、方法
無論是函數(shù)還是子程序,方法都必須以動詞或動詞短語命名。無需區(qū)分函數(shù)和子程序,也無需指明返回類型。
- Sub Open(ByVal CommandString As String)
- Function SetCopyNumber(ByVal CopyNumber As Integer)
參數(shù)需要指明ByVal還是ByRef,這一點寫起來會讓程序邊長,但非常必要。如果沒有特別情況,都使用ByVal。參數(shù)的命名方法,參考后面“變量的命名方法”。需要重載的方法,一般不寫Overloads,根據(jù)需要編寫重載的方法。
2、屬性
原則上,字段(Field)是不能公開的,要訪問字段的值,一般使用屬性。屬性以簡潔清晰的名詞命名:
- Property Concentration As Single
- Property Customer As CustomerTypes
3、事件
事件是特殊的屬性,只能在事件處理上下文中使用。命名的原則一般是動詞或動詞的分詞,通過時態(tài)表明事件發(fā)生的時間:
- Event Click As ClickEventHandler
- Event ColorChanged As ColorChangedEventHangler
VB.NET命名規(guī)范變量和常量:
常數(shù)以表明常數(shù)意義的名詞命名,一般不區(qū)分常數(shù)的類型:
- Const DefaultConcentration As Single = 0.01
在嚴格要求的代碼中,常數(shù)以c_開頭,如c_DefaultConcentration,但最好不要用它,它會帶來輸入困難。
普通類型的變量,只要用有意義的名字命名即可,不可使用簡稱和無意義的名稱諸如A,x1等,下面給出了良好的例子:
- Dim Index As Integer
- Dim NextMonthExpenditure As Decimal
- Dim CustomerName As String
不能起太長的名字,應(yīng)該盡量簡潔,如下面的例子:
- Dim VariableUsedToStoreSystemInformation As String '* 錯誤,太復(fù)雜了
- Dim SystemInformation As String '* 正確,簡單明了
- Dim sysInfo As String '* 錯誤,過于簡單
特殊情況可以考慮一個字母的變量:
- Dim g As Graphic
對于控件,應(yīng)該指明控件的類型,方法是直接在變量后面加以類名:
- Friend WithEvents NextPageButton As Button '* 按鈕
- Friend WithEvents ColorChoicerPanel As Panel '* 面版
- Friend WithEvents CardFileOpenDialog As FileOpenDialog '* 文件打開對話框
等等,無需規(guī)定某種類型的變量的前綴,只需把類型寫在后面就行了,試對比下列代碼:
- btnCancel.Text = "&Cancel"
- CancelButton.Text = "&Cancel"
顯然后者更能使閱讀者明白變量的類型是一個按鈕。
【編輯推薦】