| 価値 | |
|---|---|
| ルール識別子 | CA2263 |
| タイトル | 型が既知の場合はジェネリック オーバーロードを優先する |
| カテゴリ | 使用方法 |
| 修正が破壊的であるか非破壊的であるか | Non-breaking |
| .NET 10 で既定で有効 | 提案として |
原因
System.Type引数を受け取るメソッド オーバーロードは、コンパイル時に型がわかっており、適切なジェネリック オーバーロードが使用可能な場合に呼び出されます。
ルールの説明
ジェネリック オーバーロードは、コンパイル時に型がわかっている場合 (C# の typeof 演算子または Visual Basic の GetType 演算子を使用) にSystem.Type型の引数を受け入れるオーバーロードに適しています。 ジェネリック オーバーロードは、コンパイル時のチェックが改善され、よりクリーンでタイプ セーフなコードを促進します。
違反を修正する方法
この規則違反を修正するには、適切なジェネリック オーバーロードを使用します。
Example
次のコード スニペットは、CA2263 の違反を示しています。
int size = Marshal.SizeOf(typeof(bool));
Dim size As Integer = Marshal.SizeOf(GetType(Boolean))
次のコード スニペットは、違反を修正します。
int size = Marshal.SizeOf<bool>();
Dim size As Integer = Marshal.SizeOf(Of Boolean)()
警告を抑制するタイミング
このルールからの警告を抑制しても問題ありません。ただし、可能であればジェネリック オーバーロードを使用することをお勧めします。
警告を抑制する
単一の違反を抑制するだけの場合は、ソース ファイルにプリプロセッサ ディレクティブを追加して無効にしてから、規則をもう一度有効にします。
#pragma warning disable CA2263
// The code that's violating the rule is on this line.
#pragma warning restore CA2263
ファイル、フォルダー、またはプロジェクトのルールを無効にするには、その重大度をnoneでに設定します。
[*.{cs,vb}]
dotnet_diagnostic.CA2263.severity = none
詳細については、「 コード分析の警告を抑制する方法」を参照してください。
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。
.NET