'is null' チェックを使用する (IDE0041)

プロパティ	値
ルール ID	IDE0041
Title	'is null' チェックを使用する
カテゴリ	スタイル
Subcategory	言語規則 (式レベル基本設定)
該当言語	C# および Visual Basic
導入されたバージョン	Visual Studio 2017
[オプション]	dotnet_style_prefer_is_null_check_over_reference_equality_method

概要

このスタイル規則は、パターン マッチングによる null チェックと、等価性演算子 (==) の使用または Object.ReferenceEquals(Object, Object) の呼び出しに関するものです。

オプション

オプションでは、規則を適用する動作を指定します。 オプションの構成の詳細については、「オプションの書式」を参照してください。

dotnet_style_prefer_is_null_check_over_reference_equality_method

プロパティ	値	説明
オプション名	dotnet_style_prefer_is_null_check_over_reference_equality_method
オプションの値	true	is null チェックを優先します
	false	参照の等価性メソッドを優先します
既定のオプションの値	true

// dotnet_style_prefer_is_null_check_over_reference_equality_method = true
if (value is null)
    return;

// dotnet_style_prefer_is_null_check_over_reference_equality_method = false
if (object.ReferenceEquals(value, null))
    return;

// dotnet_style_prefer_is_null_check_over_reference_equality_method = false
if ((object)o == null)
    return;

' dotnet_style_prefer_is_null_check_over_reference_equality_method = true
If value Is Nothing
    Return
End If

' dotnet_style_prefer_is_null_check_over_reference_equality_method = false
If Object.ReferenceEquals(value, Nothing)
    Return
End If

' dotnet_style_prefer_is_null_check_over_reference_equality_method = false
If CType(value, Object) = Nothing
    Return
End If

警告を抑制する

単一の違反だけを抑制する場合は、ソース ファイルにプリプロセッサ ディレクティブを追加して無効にしてから、規則を再度有効にします。

#pragma warning disable IDE0041
// The code that's violating the rule is on this line.
#pragma warning restore IDE0041

ファイル、フォルダー、またはプロジェクトのルールを無効にするには、構成ファイルでその重要度を none に設定します。

[*.{cs,vb}]
dotnet_diagnostic.IDE0041.severity = none

すべてのコード スタイル規則を無効にするには、構成ファイルでカテゴリ Style の重要度を none に設定します。

[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-Style.severity = none

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

関連項目

• コード スタイルの言語規則
• コード スタイルの規則のリファレンス