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

財産	価値
ルール ID	IDE0041
タイトル	'is null' チェックを使用する
カテゴリ	スタイル
サブカテゴリ	言語規則 (式レベル基本設定)
該当する言語	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

警告を抑制する

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

#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

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

関連項目

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