使用 'is null' 檢查 (IDE0041)

屬性	值
規則識別碼	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

隱藏警告

若您只想隱藏單一違規，請將前置處理指示詞新增至來源檔案以停用規則，然後重新啟用規則。

#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

如需詳細資訊，請參閱如何隱藏程式碼分析警告。

另請參閱

• 程式碼樣式語言規則
• 程式碼樣式規則參考