デザイン上の警告
デザイン上の警告は、.NET Framework デザイン ガイドラインに従っています。
このセクションの内容
規則 |
Description |
|---|---|
ジェネリック型の静的メンバーを呼び出すときには、その型の型引数も指定する必要があります。推論をサポートしないジェネリック インスタンス メンバーを呼び出すときには、そのメンバーに型引数を指定する必要があります。この 2 つの場合、型引数を指定するときに使用される構文は異なりますが、混同される可能性があります。 |
|
クラスが System.IDisposable 型であるインスタンス フィールドを宣言および実装していますが、IDisposable を実装していません。IDisposable フィールドを宣言するクラスは間接的にアンマネージ リソースを所有しているため、IDisposable インターフェイスを実装する必要があります。 |
|
System.Collections.Generic.List<(Of <(T>)>) は継承ではなくパフォーマンスを目的としたジェネリック コレクションです。このため、List には仮想メンバーは含まれません。代わりに、継承を目的としたジェネリック コレクションを公開する必要があります。 |
|
型に void を返すデリゲートが含まれており、デリゲートのシグネチャに 2 つのパラメーター (1 つはオブジェクト、もう 1 つは EventArgs に割り当て可能な型) が含まれ、包含アセンブリの対象が .NET Framework 2.0 です。 |
|
型引数を明示的に指定するのではなく、メソッドに渡す引数の型によってジェネリック メソッドの型引数を決定する方法が推論されます。推論を有効にするには、ジェネリック メソッドのパラメーター シグネチャに、そのメソッドの型パラメーターと同じ型のパラメーターが含まれている必要があります。この場合、型引数を指定する必要がなくなります。すべての型パラメーターについて推論を使用する場合、ジェネリック インスタンス メソッドを呼び出す構文と、非ジェネリック インスタンス メソッドを呼び出す構文は同じになります。これにより、ジェネリック メソッドの使用方法が単純化されます。 |
|
ジェネリック型に含まれる型パラメーターが増えれば増えるほど、それぞれの型パラメーターが表す意味を調べることや覚えることが難しくなります。通常、List<T> のように型パラメーターが 1 つの場合や、Dictionary<TKey, TValue> のように型パラメーターが 2 つの場合、意味は明確です。しかし、型パラメーターが 3 つ以上になると、ほとんどのユーザーには意味を把握することが困難になります。 |
|
入れ子にされた型引数は、ジェネリック型の型引数でもあります。入れ子にされた型引数を含むシグネチャを持つメンバーを呼び出すには、ユーザーが 1 つのジェネリック型をインスタンス化し、別のジェネリック型のコンストラクターにこの型を渡す必要があります。複雑な手順と構文が必要となるため、これは避けるようにしてください。 |
|
外部から参照できるメソッドに、System.Object 型の参照パラメーターが含まれています。ジェネリック メソッドを使用することで、型を最初に参照パラメーターの型にキャストせずに、制約の影響を受けるすべての型をメソッドに渡すことができます。 |
|
初期化されていない列挙型の既定値は、他の値型と同様に、ゼロです。フラグではない属性が付いた列挙型では、ゼロの値を使用してメンバーを定義する必要があります。これは、既定の値を有効な列挙値にするためです。FlagsAttribute 属性を適用した列挙型でゼロ値のメンバーを定義する場合、名前を "None" にして、列挙型に設定済みの値がないことを示します。 |
|
イベント ハンドラー メソッドでは 2 つのパラメーターを使用します。1 つ目は System.Object 型で、"sender" という名前です。これは、イベントを発生させるオブジェクトです。2 つ目は System.EventArgs 型で、"e" という名前です。これは、イベントに関連付けられるデータです。イベント ハンドラー メソッドでは値を返さないでください。C# プログラミング言語では、これは戻り値の型 void で示されます。 |
|
コレクションの操作性を拡充するために、ジェネリック コレクション インターフェイスの 1 つを実装します。これにより、コレクションを使用してジェネリック コレクション型を設定できます。 |
|
メソッドの宣言で基本型をパラメーターとして指定すると、その基本型から派生した型は、メソッドに対応する引数として渡すことができます。派生パラメーター型で実現する追加機能が不要である場合、基本型を使用することでメソッドをより広範囲に利用できるようになります。 |
|
抽象型上のコンストラクターは、派生型からのみ呼び出すことができます。パブリック コンストラクターで型のインスタンスが作成され、抽象型のインスタンスは自分で作成できないため、パブリック コンストラクターが含まれる抽象型のデザインは不適切になります。 |
|
パブリック型またはプロテクト型で、等値演算子を実装しないまま、加算演算子または減算演算子を実装しています。 |
|
共通言語仕様 (CLS) には、名前付けの制約、データ型、および規則が定義されています。アセンブリを複数のプログラミング言語で使用する場合、この仕様に準拠する必要があります。すべてのアセンブリに CLSCompliantAttribute を使用して、CLS への準拠を明示することをお勧めします。この属性が使用されていないアセンブリは、CLS に準拠しません。 |
|
.NET Framework では、バージョン番号を使用してアセンブリを一意に識別し、厳密な名前を持つアセンブリの型にバインドします。バージョン番号は、バージョンと発行者のポリシーと共に使用されます。既定で、アプリケーションは、ビルドされたアセンブリのバージョンでのみ実行されます。 |
|
ComVisibleAttribute 属性によって、COM クライアントからマネージ コードにアクセスする方法が決まります。アセンブリで COM の参照範囲を明示することをお勧めします。COM の参照範囲は、アセンブリ全体に設定し、個々の型と型のメンバー用にオーバーライドできます。この属性がない場合、アセンブリのコンテンツは COM クライアントから参照できます。 |
|
カスタム属性を定義する場合、AttributeUsageAttribute を使用してマークし、カスタム属性を適用できるソース コードの位置を示します。属性の意味と用途によって、コード内の有効な位置が決まります。 |
|
属性では、対象に適用するときに必ず指定する必須の引数を定義できます。この引数は、コンストラクターに位置指定パラメーターで属性を指定できるようになるため、位置指定引数とも呼ばれます。必須のすべての引数について、対応する読み取り専用のプロパティも属性で規定する必要があります。これは、引数値を実行時に取得できるようにするためです。また、属性ではオプションの引数も定義できます。これは名前付き引数とも呼ばれます。この引数は、名前でコンストラクターに属性を指定するときに使用されます。また、対応する読み取り/書き込みプロパティが必要です。 |
|
配置する型数の少ない名前空間を作成する場合、各名前空間を論理的に構成し、有効な理由を付けます。 |
|
(out または ref を使用した) 型の参照渡しには、ポインターの使用経験、値型と参照型の違いの理解、および複数の戻り値を持つメソッドの処理が必要です。また、out パラメーターと ref パラメーターの違いはあまり理解されていません。 |
|
インデクサー (つまり、インデックス付きのプロパティ) では、インデックスを 1 つだけ使用します。多次元のインデクサーがあると、ライブラリの操作性が著しく低下することがあります。 |
|
パブリック メソッドまたはプロテクト メソッドに、"Get" で始まる名前が付けられ、パラメーターは使用されていません。また、配列ではない値を返します。このメソッドは、プロパティに変更できる可能性があります。 |
|
引数の正確な数が不明で、可変個の引数が同じ型である場合、または同じ型で渡すことができる場合、引数を繰り返すのではなく、パラメーター配列を使用します。 |
|
既定のパラメーターを使用するメソッドは、CLS で許可されていますが、CLS では、既定のパラメーターに割り当てられた値をコンパイラで無視することもできます。複数のプログラミング言語間で動作を維持するために、既定のパラメーターを使用するメソッドは、既定のパラメーターを指定したメソッドのオーバーロードで置換します。 |
|
列挙型は、関連する名前付き定数が複数定義された値型です。名前付き定数を有意に結合できる場合、列挙型に FlagsAttribute を適用します。 |
|
列挙型は、関連する名前付き定数が複数定義された値型です。既定で、System.Int32 データ型は、定数値を格納するために使用されます。この基になる型を変更できる場合でも、ほとんどの場合、変更する必要はなく、推奨もされません。 |
|
この規則では、通常はイベントに使用される名前を持つメソッドを検出します。明示的に定義された状態変化に応答してメソッドが呼び出される場合、メソッドはイベント ハンドラーから呼び出す必要があります。メソッドを呼び出すオブジェクトは、メソッドを直接呼び出すのではなく、イベントを発生させる必要があります。 |
|
汎用的な例外はキャッチしないでください。より具体的な例外をキャッチするか、汎用的な例外を catch ブロックの最後のステートメントでスローし直します。 |
|
コンストラクターを完全に宣言していないと、例外を正しく処理するのが困難になります。 |
|
シールされていない外部から参照できる型によって、パブリック インターフェイスを持つメソッドを明示的に実装しています。また、同じ名前を持つ外部から参照できる代替のメソッドがありません。 |
|
入れ子にされた型とは、別の型のスコープ内で宣言された型のことです。入れ子にされた型は、包含型のプライベート実装の詳細をカプセル化するときに便利です。このような用途なので、入れ子にされた型は外部から参照できないようにします。 |
|
この規則では、ICollection で厳密に型指定されたメンバーを実装する必要があります。これは、ユーザーがインターフェイスに備わっている機能を使用するときに、必ずしも引数を Object 型にキャストするとは限らないためです。この規則では、ICollection を実装する型でこの処理を行って、Object よりも厳密な型のインスタンス コレクションを管理すると想定しています。 |
|
パブリック型またはプロテクト型で System.IComparable インターフェイスを実装しています。これによって、Object.Equals はオーバーライドされません。また、"等しい"、"等しくない"、"未満"、"より大きい" を示す言語固有の演算子はオーバーロードされません。 |
|
この規則では、IEnumerator で、厳密に型指定された形式の Current プロパティを実装する必要があります。これは、ユーザーは、インターフェイスに備わっている機能を使用するときに、必ずしも戻り値を厳密な型にキャストするとは限らないためです。 |
|
この規則では、IList で厳密に型指定されたメンバーを実装する必要があります。これは、ユーザーがインターフェイスに備わっている機能を使用するときに、必ずしも引数を System.Object 型にキャストするとは限らないためです。 |
|
インターフェイスには、動作や使用のコントラクトを実現するメンバーが定義されます。インターフェイスで示される機能は、継承の階層構造内に型が存在するかどうかにかかわらず、どの型からも適用できます。型ではインターフェイスのメンバーに実装することで、インターフェイスが実装されます。空のインターフェイスではメンバーが定義されません。そのため、実装できるコントラクトも定義されません。 |
|
型またはメンバーが System.ObsoleteAttribute 属性を使用してマークされていますが、この属性で ObsoleteAttribute.Message プロパティが指定されていません。ObsoleteAttribute を使用してマークされている型またはメンバーをコンパイルすると、属性の Message プロパティが表示されます。これによって、ユーザーは旧式の型またはメンバーに関する情報を知ることができます。 |
|
インデクサー (つまり、インデックスされたプロパティ) では、インデックスに整数型または文字列型を使用します。一般に、このような型はデータ構造のインデックス作成に使用され、ライブラリの操作性も改善されます。Object 型の使用は、デザイン時に特定の整数型または文字列型を指定できない場合に限定してください。 |
|
読み取り専用のプロパティは許容され、必要な場合もよくありますが、書き込み専用のプロパティを使用することはデザインのガイドラインで禁止されています。これは、値を設定できてもその値を参照できず、セキュリティが確保されないためです。また、読み取りアクセスがないと、共有オブジェクトのステータスを参照できないため、実用性が制限されます。 |
|
(out または ref を使用した) 型の参照渡しには、ポインターの使用経験、値型と参照型の違いの理解、および複数の戻り値を持つメソッドの処理が必要です。開発者全般に向けてライブラリをデザインする場合、ユーザーが out パラメーターまたは ref パラメーターの扱い方を習得することは期待しないでください。 |
|
参照型の場合、等値演算子は既定の実装でほぼ問題がありません。既定で、2 つの参照が等値と見なされるのは、同じオブジェクトを参照する場合のみです。 |
|
型でプロテクト メンバーを宣言するのは、継承する型からメンバーにアクセスまたはオーバーライドできるようにするためです。定義により、シールされた型から継承することはできません。これは、シールされた型のプロテクト メソッドを呼び出すことができないということを意味します。 |
|
型でメソッドを仮想と宣言するのは、継承する型が仮想メソッドの実装をオーバーライドできるようにするためです。定義により、シールされた型から継承することはできません。これにより、シールされた型の仮想メソッドの意味がなくなります。 |
|
アンマネージ リソースを割り当てる型では、IDisposable を実装することで、呼び出し元が必要に応じてリソースを解放し、リソースを保持するオブジェクトの有効期間を短縮できるようにする必要があります。 |
|
型を名前空間内で宣言するのは、名前が衝突しないようにするためと、関連する型をオブジェクト階層形式で編成するためです。 |
|
フィールドの主な用途は、実装の詳細にする必要があります。フィールドは private または internal にし、プロパティによって公開するようにします。 |
|
パブリック型またはプロテクト型に静的メンバーしかなく、sealed (C#) または NotInheritable (Visual Basic) 修飾子を使用して宣言されていません。継承を意図していない型は、sealed 修飾子を使用してマークし、基本型として使用できないようにします。 |
|
パブリック型または入れ子になったパブリック型で、静的なメンバーのみが宣言されています。また、パブリックまたはプロテクトの既定のコンストラクターが含まれます。静的メンバーの呼び出しに型のインスタンスは必要ないため、コンストラクターは不要です。安全性とセキュリティを確保するために、文字列引数を使用して文字列オーバーロードで URI (Uniform Resource Identifier) オーバーロードを呼び出してください。 |
|
メソッドで URI の文字列形式を使用する場合、対応するオーバーロードを宣言し、URI クラスのインスタンスを使用します。こうすることで、安全な方法でこのサービスを実現できます。 |
|
この規則では、メソッドは URI を返すと想定されます。URI の文字列表現は解析エラーやエンコーディング エラーが発生しやすく、セキュリティ上の脆弱性の原因となる場合があります。System.Uri クラスを使用すると、安全な方法でこのサービスを実現できます。 |
|
この規則では、プロパティは URI を表すと想定されます。URI の文字列表現は解析エラーやエンコーディング エラーが発生しやすく、セキュリティ上の脆弱性の原因となる場合があります。System.Uri クラスを使用すると、安全な方法でこのサービスを実現できます。 |
|
文字列パラメーターが System.Uri パラメーターに置き換えられている点だけが異なるメソッド オーバーロードが型で宣言されています。文字列パラメーターを使用するオーバーロードは、URI パラメーターを使用するオーバーロードを呼び出しません。 |
|
外部から参照可能な型では、特定の基本型が拡張されます。別の型を使用してください。 |
|
具象型は、完全な実装を含む型であるため、インスタンス化できます。このメンバーを広範囲に使用するには、具象型を推奨インターフェイスによって置き換えます。 |
|
System.Runtime.InteropServices.DllImportAttribute でマークされているメソッドなどのプラットフォーム呼び出しメソッド、または Visual Basic で Declare キーワードを使用して定義されたメソッドが、アンマネージ コードにアクセスしています。これらのメソッドは、NativeMethods、SafeNativeMethods、UnsafeNativeMethods の各クラスのいずれかに含まれる必要があります。 |
|
派生メソッドのパラメーター シグネチャ内のある型が、基本メソッドのパラメーター シグネチャ内のそれに対応する型より弱く型指定されていることが、両者の唯一の相違点である場合、基本型内のメソッドが派生型内の同じ名前のメソッドによって隠ぺいされます。 |
|
外部から参照可能なメソッドに渡されるすべての参照引数について、null かどうかをチェックする必要があります。 |
|
すべての IDisposable 型は、Dispose パターンを適切に実装する必要があります。 |
|
内部例外は、その内部スコープ内でのみ認識されます。内部スコープの外側にある例外は、基本例外を使用しなければキャッチできません。内部例外が System.Exception、System.SystemException、または System.ApplicationException を継承している場合、外部コードはその例外の処理に関する十分な情報を取得できません。 |
|
例外をスローしないはずのメソッドが例外をスローします。 |
|
厳密な名前によって、改ざんされたアセンブリを、クライアントが無意識のうちに読み込む問題を防ぐことができます。厳密な名前のないアセンブリが配置される状況は、限定されます。適切に署名されていないアセンブリを共有または配布すると、アセンブリが改ざんされる場合、共通言語ランタイムでアセンブリを読み込むことができない場合、またはユーザーのコンピューターで検証を無効にする必要がある場合などの問題が考えられます。 |