CA2264: 'ArgumentNullException.ThrowIfNull' に null 非許容値を渡さないでください
プロパティ | 値 |
---|---|
ルール ID | CA2264 |
Title | Null 非許容値を 'ArgumentNullException.ThrowIfNull' に渡さないでください |
カテゴリ | 使用方法 |
修正が中断ありか中断なしか | なし |
.NET 9 では既定で有効 | 警告として |
原因
null でないことがわかっている値が渡されると ArgumentNullException.ThrowIfNull()
、例外はスローされず、ステートメントは no-op になります。
規則の説明
ArgumentNullException.ThrowIfNull
は、渡された引数 null
が . null 非許容構造体 (除 Nullable<T>く)、'nameof()' 式、および 'new' 式のような特定のコンストラクトは、null になることは決してないため、 ArgumentNullException.ThrowIfNull
スローされることはありません。
構造体の場合、構造体が受け入れられるobject?
ためArgumentNullException.ThrowIfNull
、構造体はボックス化されるため、パフォーマンスが低下します。
違反の修正方法
呼び出しを削除します ArgumentNullException.ThrowIfNull
。
例
次のコード スニペットは、CA2264 の違反を示しています。
static void Print(int value)
{
ArgumentNullException.ThrowIfNull(value);
Console.WriteLine(value);
}
次のコード スニペットでは違反を修正しています。
static void Print(int value)
{
Console.WriteLine(value.Value);
}
どのようなときに警告を抑制するか
この警告は常に安全に抑制できます。
警告を抑制する
単一の違反を抑制するだけの場合は、ソース ファイルにプリプロセッサ ディレクティブを追加して無効にしてから、規則をもう一度有効にします。
#pragma warning disable CA2264
// The code that's violating the rule is on this line.
#pragma warning restore CA2264
ファイル、フォルダー、またはプロジェクトの規則を無効にするには、構成ファイルでその重要度を none
に設定します。
[*.{cs,vb}]
dotnet_diagnostic.CA2264.severity = none
詳細については、「コード分析の警告を抑制する方法」を参照してください。
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。
.NET