使用 '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

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

另請參閱

• 程式代碼樣式語言規則
• 程式代碼樣式規則指南