Použijte kontrolu pomocí 'is null' (IDE0041)

Článek
08. 02. 2025

Vlastnost	Hodnota
ID pravidla	IDE0041
název	Použijte kontrolu 'is null'
kategorie	Styl
podkategorie	Jazyková pravidla (předvolby na úrovni výrazu)
příslušné jazyky	C# a Visual Basic
Zavedená verze	Visual Studio 2017
Možnosti	`dotnet_style_prefer_is_null_check_over_reference_equality_method`

Přehled

Toto pravidlo stylu je o použití kontroly null pomocí vzorového porovnání versus používání operátoru rovnosti (==) nebo volání Object.ReferenceEquals(Object, Object).

Volby

Možnosti určují chování, které má pravidlo vynutit. Informace o konfiguraci nastavení naleznete v tématu Formát nastavení.

dotnet_style_prefer_is_null_check_over_reference_equality_method

Vlastnost	Hodnota	Popis
název možnosti	dotnet_style_prefer_is_null_check_over_reference_equality_method
hodnoty možností	`true`	Preferujte kontrolu `is null`
	`false`	Preferovat metodu rovnosti referencí
výchozí hodnota možnosti	`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

Potlačte upozornění

Pokud chcete potlačit pouze jedno porušení, přidejte do zdrojového souboru direktivy preprocesoru, abyste pravidlo zakázali a znovu povolili.

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

Chcete-li pravidlo pro soubor, složku nebo projekt zakázat, nastavte jeho závažnost na none v konfiguračním souboru .

ini

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

Chcete-li zakázat všechna pravidla stylu kódu, nastavte závažnost pro kategorii Style na none v konfiguračním souboru .

ini

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

Další informace naleznete v tématu Jak potlačit upozornění analýzy kódu.

Sdílet prostřednictvím