編碼規范
注:編碼只是準則,而不是規范。
- 變量命名:單詞首字母大寫;
- EmployeeSalary
- 命名空間和類:同上,最好不使用帶有下劃線的單詞;
- 采用大小寫命名規則:employeeSalary;
- 類型中所有私有成員字段的名稱;(注:成員字段的前綴名常常用一條下劃線開頭;)
- 傳遞給方法的所有參數名稱;
- 用于區分兩個同名的對象;(比較常見的就是屬性封裝的字段)
- 屬性和方法的使用
如果要編碼的相關項滿足下述所有條件,就把他設置為屬性,否則就應該使用方法;
- 客戶端代碼應能讀取它的值,最好不要使用只寫屬性,例如,應使用SetPassword()方法,而不是Password只寫屬性;
- 讀取值不應該花太長的時間,如果是屬性通常表明讀取過程花的時間相對較短;
- 讀取該值不應有任何明顯的和不希望的負面效應,設置屬性的值不應有與該屬性不直接相關的負面效應。如設置對話框的寬度會改變對話框在屏幕上的展示外觀,這是可以的。因為它與歸屬性相關;
- 可以按照任何順序設置屬性,尤其在設置屬性時,最好不要因為還沒有設置另一個相關的屬性而拋出異常。例如:如果為了訪問數據庫的類,則需要設置屬性ConnectionString、UserName和Password,應該確保已經實現了該類這樣用戶才能按照順序設置他們。
- 順序讀取屬性應有相同的結果。如果屬性的值有不可預料的改變,就應該把它編寫為一個方法。例如:在檢測汽車運動的類中,把Speed(速度)設置為屬性就不合適,應該使用GetSpeed()方法;另一方面應該吧Weight(重量)和EngineSize(發動機尺寸)設置為屬性,因為他們是不變的。
- 字段的使用
- 字段應該都是私有的,某些情況下也可以把常量或只讀字段設置為公開的,如果把字段設置為公開的,就不利于以后擴展或者修改類。

浙公網安備 33010602011771號