次の方法で共有


型のメンバの名前

更新 : 2007 年 11 月

型には、次の種類のメンバが含まれます。

  • メソッド

  • プロパティ

  • フィールド

  • イベント

以下のガイドラインに従うと、クラス ライブラリのデザイン時に .NET Framework に適合するメンバの名前を選択できます。

メソッドの名前

メソッド名には、動詞または動詞句を割り当ててください。

通常、メソッドはデータを操作するため、メソッドのアクションを表す動詞を使用すると、開発者にはメソッドの機能がよりわかりやすくなります。メソッドが実行するアクションを定義するときは、開発者から見てわかりやすい名前を選択するように注意してください。メソッドがアクションを実行する方法を表す動詞は使用しないでください。言い換えると、メソッド名には実装の詳細を使用しないでください。

プロパティの名前

プロパティの名前には、名詞、名詞句、または形容詞を使用してください。

プロパティはデータを保持するため、名詞句や形容詞が適切です。

Get メソッドと同じ名前のプロパティは使用しないでください。

たとえば、プロパティに EmployeeRecord という名前を付け、またメソッドにも GetEmployeeRecord という名前を付けるということはしないでください。開発者が各自のプログラミング タスクを実行する際にどのメンバを使用したらいいかわからなくなるからです。

プロパティには、その型と同じ名前を付けるようにしてください。

列挙型に厳密に型指定されたプロパティを使用する場合は、プロパティの名前を列挙型の名前と同じにできます。たとえば、CacheLevel という名前の列挙型がある場合は、その値のいずれかを返すプロパティにも CacheLevel という名前を付けることができます。

イベントの名前

イベント ハンドラ シグネチャでは、sender および e という名前の 2 つのパラメータを使用してください。

sender パラメータは Object 型とし、e パラメータは、EventArgs のインスタンスとするか、またはこれを継承する必要があります。

フィールドの名前

フィールドの名前付けガイドラインは、静的なパブリック フィールドとプロテクト フィールドに適用されます。パブリック インスタンス フィールドやプロテクト インスタンス フィールドは定義しないでください。詳細については、「フィールドのデザイン」を参照してください。

フィールド名にはプリフィックスを使用しないでください。たとえば、静的フィールドと非静的フィールドを区別するために、g_ や s_ を使用しないでください。

Portions Copyright 2005 Microsoft Corporation.All rights reserved.

Portions Copyright Addison-Wesley Corporation.All rights reserved.

デザイン ガイドラインの詳細については、2005 年に Addison-Wesley から出版されている Krzysztof Cwalina、Brad Abrams 共著の『Framework Design Guidelines: Conventions, Idioms, and Patterns for Reusable .NET Libraries』を参照してください。

参照

その他の技術情報

クラス ライブラリ開発のデザイン ガイドライン

名前に関するガイドライン