2022-07-08|閱讀時間 ‧ 約 3 分鐘

Microsoft C# | 命名規則

前言

  在之前的文章有提過命名規則,這是為了程式員可以更好的彼此溝通和事後維護而訂定的軟性規則,如果不遵守也沒有強制力,不過就是比較難溝通,而且自己未來可能會看不懂。

變數命名規則

  • 變數名稱只能包含英數字元與底線字元。 不允許使用井字號 #、破折號 `` 與貨幣符號 $ 等特殊字元。
  • 變數名稱的開頭必須是字母或底線,而不是數字。 開發人員會針對特殊用途使用底線,因此請試著暫時不要使用它。
  • 變數名稱「不得」為 C# 關鍵字。 例如,不允許使用下列變數名稱宣告:float float; 或 string string;。
  • 變數名稱會區分大小寫,這表示 string MyValue; 與 string myValue; 是兩個不同的變數。

變數名稱慣例

  • 變數名稱應該使用駝峰式大小寫,這是一種撰寫樣式,它會在第一個單字開頭使用小寫字母,並在每個後續單字的開頭都使用大寫字母。 例如:string thisIsCamelCase;。
  • 變數名稱在您的應用程式中應該是描述性且有意義的。 您應該針對您變數所保留的資料種類,選擇其名稱。
  • 變數名稱應該是一或多個完整的單字附加在一起。 請勿使用縮寫,因為讀取您程式碼的其他人可能不清楚該變數的名稱。
  • 變數名稱不應包含變數的資料類型。 您可能會看到一些使用樣式 (例如 string strMyValue;) 的建議。 這是多年前常用的樣式。 不過,大部分的開發人員都不再遵循這個建議。

其它命名慣例

  我們所檢閱的規則和慣例適用於區域變數,區域變數是在方法主體內設定範圍的變數。
  類別也支援可見度修飾詞,可讓一些值變成私人或公用。 私人成員只能由相同類別中的其他成員參考。 公用成員則可以在類別外部參考。 因此,您可以建立私人欄位或公用欄位。

結語

  在這之前其實有寫過一篇文章專門提一次命名規則,藉由從Microsoft官方的教學來重新回顧一次命名規則,並且了解歸方對命名規則的看法和邏輯是很不錯的方法,原本就有提過不同程式員有不同的命名規則,這次剛好可以看看官方的命名規則。
分享至
成為作者繼續創作的動力吧!
© 2024 vocus All rights reserved.