Użyj sprawdzania "is null" (IDE0041)

  • Artykuł
Właściwość Wartość
Identyfikator zasady IDE0041
Tytuł Użyj sprawdzania "is null"
Kategoria Styl
Subcategory (Podkategoria) Reguły języka (preferencje na poziomie wyrażeń)
Odpowiednie języki C# i Visual Basic
Wprowadzona wersja Visual Studio 2017
Opcje dotnet_style_prefer_is_null_check_over_reference_equality_method

Omówienie

Ta reguła stylu dotyczy użycia sprawdzania wartości null z dopasowaniem wzorca w porównaniu z użyciem operatora równości (==) lub wywołania metody Object.ReferenceEquals(Object, Object).

Opcje

Opcje określają zachowanie, które ma być wymuszane przez regułę. Aby uzyskać informacje na temat konfigurowania opcji, zobacz Format opcji.

dotnet_style_prefer_is_null_check_over_reference_equality_method

Właściwość Wartość Opis
Nazwa opcji dotnet_style_prefer_is_null_check_over_reference_equality_method
Wartości opcji true Preferuj is null sprawdzanie
false Preferuj metodę równości odwołań
Wartość opcji domyślnej 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

Pomijanie ostrzeżenia

Jeśli chcesz pominąć tylko jedno naruszenie, dodaj dyrektywy preprocesora do pliku źródłowego, aby wyłączyć, a następnie ponownie włączyć regułę.

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

Aby wyłączyć regułę dla pliku, folderu lub projektu, ustaw jego ważność na none w pliku konfiguracji.

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

Aby wyłączyć wszystkie reguły stylu kodu, ustaw ważność kategorii Style na none w pliku konfiguracji.

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

Aby uzyskać więcej informacji, zobacz Jak pominąć ostrzeżenia analizy kodu.

Zobacz też