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