按一下以給予評分及指教
MSDN
MSDN Library
.NET 開發
先前版本
一般參考
命名方針
 型別成員名稱

  開啟低頻寬檢視
本頁僅適用於
Microsoft Visual Studio 2005/.NET Framework 2.0

其他版本也適用於下列軟體:
.NET Framework 開發人員手冊
型別成員名稱

型別包含下列的成員類型:

  • 方法

  • 屬性

  • 欄位

  • 事件

本章節中的方針將協助類別庫設計人員選取與 .NET Framework 一致的成員名稱。

方法的名稱

要提供動詞命令或動詞命令片語的方法名稱。

一般來說,方法會在資料上作業,所以使用動詞命令來描述方法的動作可讓開發人員更容易瞭解方法的工作。當定義方法所執行的動作時,請務必要謹慎選取開發人員觀點中覺得明確的名稱。請勿選取一個描述方法如何執行其工作的動詞命令;換句話說,請勿針對方法名稱使用實作的細節。

屬性的名稱

要使用名詞、名詞片語或形容詞來命名屬性。

為屬性使用名詞片語或形容詞來命名是適合的方式,因為屬性可保存資料。

不要使用符合 Get 方法名稱的屬性。

例如,不要將屬性命名為 EmployeeRecord 並同時將方法命名為 GetEmployeeRecord,開發人員將無法知道要使用哪一個成員來完成程式設計工作。

要使用肯定片語來命名 Boolean 屬性 (如 CanSeek,而非 CantSeek)。您也可以選擇使用 Is、Can 或 Has 來當做 Boolean 屬性的前置詞,但是只能在加入值的地方。

請考慮為屬性提供與其型別相同的名稱。

當您的屬性對於列舉型別是強型別時,此屬性的名稱可以與此列舉型別的名稱相同。例如,如果您的列舉型別名為 CacheLevel,則傳回它的一個值的屬性也可命名為 CacheLevel

事件的名稱

要使用動詞命令或動詞命令片語來命名事件。

要使用現在式和過去式為事件名稱提供過去和將來的概念。例如,在視窗關閉之前引發的關閉事件可稱為 Closing,而在視窗關閉之後引發的關閉事件可稱為 Closed。

不要使用 Before 或 After 前置詞或尾碼來指示預期事件和過去事件。

要使用 EventHandler 尾碼來命名事件處理常式 (當做事件型別使用的委派)。

要在事件處理常式簽名碼中使用兩個名為 sender 和 e 的參數。

sender 參數應該具有 Object 的型別,而 e 參數應該是 EventArgs 的執行個體,或從它繼承而來。

要使用 EventArgs 尾碼來命名事件引數類別。

欄位的名稱

欄位的命名方針適用於靜態公用欄位和受保護欄位;您不應該定義公用或受保護的執行個體欄位。如需詳細資訊,請參閱欄位設計

要在欄位名稱中使用 Pascal 命名法的大小寫慣例。

要使用名詞或名詞片語來命名欄位。

不要在欄位名稱上使用前置詞。例如,不要使用 g_ 或 s_ 來區別靜態和非靜態的欄位。

Portions Copyright 2005 Microsoft Corporation.All rights reserved.

Portions Copyright Addison-Wesley Corporation.All rights reserved.

如需設計方針的詳細資訊,請參閱由 Krzysztof Cwalina 和 Brad Abrams 所著,並由 Addison-Wesley 於 2005 年發行的「Framework 設計方針:可重複使用之 .NET 程式庫的慣例、慣用語法和模式」一書。

請參閱

社群內容   什麼是社群內容?
新增內容 RSS  註解
Processing
© 2009 Microsoft Corporation. 著作權所有,並保留一切權利。 使用規定  |  商標  |  隱私權聲明
Page view tracker