型のメンバーの名前
型には、次の種類のメンバーが含まれます。
メソッド
プロパティ
フィールド
イベント
以下のガイドラインに従うと、クラス ライブラリのデザイン時に .NET Framework に適合するメンバーの名前を選択できます。
メソッドの名前
メソッド名には、動詞または動詞句を割り当ててください。
通常、メソッドはデータを操作するため、メソッドのアクションを表す動詞を使用すると、開発者にはメソッドの機能がよりわかりやすくなります。 メソッドが実行するアクションを定義するときは、開発者から見てわかりやすい名前を選択するように注意してください。 メソッドがアクションを実行する方法を表す動詞は使用しないでください。言い換えると、メソッド名には実装の詳細を使用しないでください。
プロパティの名前
プロパティの名前には、名詞、名詞句、または形容詞を使用してください。
プロパティはデータを保持するため、名詞句や形容詞が適切です。
Get メソッドと同じ名前のプロパティは使用しないでください。
たとえば、プロパティに EmployeeRecord という名前を付け、またメソッドにも GetEmployeeRecord という名前を付けるということはしないでください。 開発者が各自のプログラミング タスクを実行する際にどのメンバーを使用したらいいかわからなくなるからです。
ブール型のプロパティの名前には、肯定的なフレーズ (CantSeek ではなく CanSeek など) を使用してください。 ブール型のプロパティには、Is、Can、Has などのプリフィックスを付けることもできますが、これは有益な場合に限定してください。
プロパティには、その型と同じ名前を付けるようにしてください。
列挙型に厳密に型指定されたプロパティを使用する場合は、プロパティの名前を列挙型の名前と同じにできます。 たとえば、CacheLevel という名前の列挙型がある場合は、その値のいずれかを返すプロパティにも CacheLevel という名前を付けることができます。
イベントの名前
イベントの名前には、動詞または動詞句を使用してください。
イベント名には、現在形と過去形を使用して、前後の概念を与えてください。 たとえば、ウィンドウを閉じる前に発生させるクローズ イベントには Closing という名前を付け、ウィンドウを閉じた後に発生させるクローズ イベントには Closed という名前を付けます。
プレイベントやポストイベントを表すために、Before または After というプリフィックスやサフィックスを使用しないでください。
イベント ハンドラー (イベントの型として使用されるデリゲート) の名前には、EventHandler というサフィックスを付けてください。
イベント ハンドラー シグネチャでは、sender および e という名前の 2 つのパラメーターを使用してください。
sender パラメーターは Object 型とし、e パラメーターは、EventArgs のインスタンスとするか、またはこれを継承する必要があります。
イベント引数クラスの名前には、EventArgs というサフィックスを付けてください。
フィールドの名前
フィールドの名前付けガイドラインは、静的なパブリック フィールドとプロテクト フィールドに適用されます。 パブリック インスタンス フィールドやプロテクト インスタンス フィールドは定義しないでください。 詳細については、「フィールドのデザイン」を参照してください。
フィールド名には Pascal 形式を使用してください。
フィールドの名前には、名詞や名詞句を使用してください。
フィールド名にはプリフィックスを使用しないでください。 たとえば、静的フィールドと非静的フィールドを区別するために、g_ や s_ を使用しないでください。
Portions Copyright 2005 Microsoft Corporation. All rights reserved.
Portions Copyright Addison-Wesley Corporation. All rights reserved.
設計ガイドラインの詳細についてを参照してください、「フレームワークの設計ガイドライン。規則、慣用句、および再利用可能なパターン。ネット ライブラリ」本クシシュトフ Cwalina、ブラッド エイブラムス、アスキー、2005 年発表しました。