名前付けの警告
名前付けの警告は、.NET Framework デザイン ガイドラインの名前付け規則の順守をサポートします。
このセクションの内容
規則 |
Description |
---|---|
この規則では、"reserved" を含む名前の列挙体のメンバーは、現在使用されていなくても、将来的なバージョンでは名前を変更するか削除されるプレースホルダーと想定しています。メンバーの名前変更や削除は、互換性に影響する変更点です。 |
|
イベント名が "Before" または "After" で始まっています。特定のシーケンスで発生する関連イベントに名前を付ける場合、現在時制または過去時制を使用して、アクション シーケンスの相対的な位置を示します。 |
|
パブリック列挙体に System.FlagsAttribute 属性があり、その名前の末尾に "s" がありません。FlagsAttribute でマークされた型は複数形の名前を持ちます。これは、この属性が複数の値を指定できることを示すからです。 |
|
外部から参照できる識別子の名前に Microsoft スペル チェック ライブラリで認識されない語が 1 つ以上含まれています。 |
|
名前空間、型、メンバー、およびパラメーターの各識別子は、大文字/小文字以外のみでは区別できません。共通言語ランタイムを対象とする言語は、大文字と小文字を区別する必要はないためです。 |
|
外部から参照できるインターフェイスの名前が大文字の "I" から始まっていません。外部から参照できる型またはメソッドのジェネリック型パラメーターの名前が、大文字の "T" から始まっていません。 |
|
外部から参照できるメンバーのパラメーター名にデータ型の名前が含まれているか、外部から参照できるメンバーの名前に言語固有のデータ型の名前が含まれています。 |
|
規則では、特定のプログラミング要素にのみ、固有のプレフィックスで始まる名前を付けることができます。 |
|
規則では、特定の基本型を拡張する型、特定のインターフェイスを実装する型、またはそのような型から派生した型の名前にのみ、固有の予約済みサフィックスを末尾に付けます。その他の型名では、予約済みのサフィックスを使用しないでください。 |
|
名前付け規則では、列挙体の複数形の名前は同時に複数の列挙値を指定できることを意味します。 |
|
オーバーライド階層のパラメーターに対する一貫性のある名前付けによって、メソッド オーバーライドの有用性が高まります。派生メソッドのパラメーター名が基本宣言のパラメーター名と異なる場合、メソッドが基本メソッドのオーバーライドであるか、またはメソッドの新しいオーバーライドであるかについて混乱が生じる可能性があります。 |
|
パラメーターはパラメーターの意味、メンバーはメンバーの意味を伝える名前にします。この 2 つの名前が一致するデザインは、まれにしか見られません。パラメーターにメンバーと同じ名前を付けるとわかりづらくなり、ライブラリの操作が難しくなります。 |
|
リソース文字列内の語は、大文字と小文字に基づくトークンに分割されます。Microsoft スペル チェック ライブラリは、隣接する 2 つのトークンの組み合わせを個別にチェックします。それらが認識されると、その語はこの規則への違反となります。 |
|
リソース文字列に Microsoft スペル チェック ライブラリで認識されない語が 1 つ以上含まれています。 |
|
型の名前は、.NET Framework クラス ライブラリで定義されている名前空間の名前と一致しないようにする必要があります。この規則に違反すると、ライブラリが使いづらくなります。 |
|
名前付け規則では、識別子名にアンダースコア (_) 文字を含めることができません。この規則により、名前空間、型、メンバー、およびパラメーターがチェックされます。 |
|
パブリック メンバーまたはプロテクト メンバーの名前が、"Get" から始まっているか、パブリック プロパティまたはプロテクト プロパティの名前と一致します。Get メソッドとプロパティは、機能を明確に区別できる名前にします。 |
|
名前空間の名前または型の名前が、プログラミング言語で、予約済みのキーワードと一致します。名前空間と型の識別子は、共通言語ランタイムを対象にする言語で定義されているキーワードと一致しないようにします。 |
|
外部から参照可能な識別子の名前に含まれている用語に対応する、別の推奨される用語があります。あるいは、名前に "Flag" または "Flags" という語が含まれています。 |
|
名前付け規則では、パラメーター名には Camel 形式が使用され、名前空間、型、およびメンバーの名前には Pascal 形式が使用されます。 |
|
識別子の名前に複数の語が含まれており、大文字と小文字が正しく使い分けられていない複合語が 1 つ以上あります。 |
|
型の情報は開発ツールで表示されるため、列挙型のメンバー名には、型名のプレフィックスを付けません。 |
|
名前付け規則によると、特定の基本型を拡張した型、特定のインターフェイスを実装する型、またはそのような型の派生型は、基本型やインターフェイスに関連するサフィックスを名前に付けます。 |