CA2263: 型がわかっている場合はジェネリック オーバーロードを優先する

	Value
ルール ID	CA2263
Title	型が既知の場合はジェネリック オーバーロードを優先する
カテゴリ	使用方法
修正が中断ありか中断なしか	なし
.NET 9 では既定で有効	提案として

原因

引数を受け取る System.Type メソッド オーバーロードは、コンパイル時に型がわかっており、適切なジェネリック オーバーロードが使用可能な場合に呼び出されます。

規則の説明

ジェネリック オーバーロードは、コンパイル時に型がわかっている場合に型System.Typeの引数を受け入れるオーバーロードに適しています (C# の typeof 演算子または Visual Basic の GetType 演算子を使用)。 ジェネリック オーバーロードは、コンパイル時のチェックが向上クリーン、より型セーフなコードを昇格させます。

違反の修正方法

この規則違反を修正するには、適切なジェネリック オーバーロードを使用します。

例

次のコード スニペットは、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

詳細については、「コード分析の警告を抑制する方法」を参照してください。