Compartilhar via


Usar a verificação 'is null' (IDE0041)

Propriedade Valor
ID da regra IDE0041
Título Usar a verificação 'is null'
Categoria Estilo
Subcategoria Regras de linguagem (preferências no nível de expressão)
Linguagens aplicáveis C# e Visual Basic
Versão introduzida Visual Studio 2017
Opções dotnet_style_prefer_is_null_check_over_reference_equality_method

Visão geral

Essa regra de estilo diz respeito ao uso de uma verificação de nulidade com padrões correspondentes versus o uso do operador de igualdade (==) ou da chamada de Object.ReferenceEquals(Object, Object).

Opções

As opções especificam o comportamento que você quer que a regra imponha. Para obter informações sobre como configurar as opções, confira Formato da opção.

dotnet_style_prefer_is_null_check_over_reference_equality_method

Propriedade Valor Descrição
Nome da opção dotnet_style_prefer_is_null_check_over_reference_equality_method
Valores da opção true Prefira verificação is null
false Prefira o método de igualdade de referência
Valor da opção padrão 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

Suprimir um aviso

Se você quiser suprimir apenas uma violação, adicione diretivas de pré-processador ao arquivo de origem para desabilitar e, em seguida, reabilite a regra.

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

Para desabilitar a regra em um arquivo, uma pasta ou um projeto, defina a severidade como none no arquivo de configuração.

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

Para desabilitar todas as regras de estilo de código, defina a severidade da categoria Style como none no arquivo de configuração.

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

Para obter mais informações, confira Como suprimir avisos de análise de código.

Confira também