Partilhar via


Utilize a verificação 'é nulo' (IDE0041)

Propriedade Valor
ID da regra IDE0041
Título Use a verificação 'é nulo'
Categoria Estilo
Subcategoria Regras de idioma (preferências no nível da expressão)
Idiomas 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

Esta regra de estilo diz respeito ao uso de uma verificação de nulidade com correspondência de padrões em vez do uso do operador de igualdade (==) ou a chamada a Object.ReferenceEquals(Object, Object).

Opções

As opções especificam o comportamento que você deseja que a regra imponha . Para obter informações sobre como configurar opções, consulte Formato de 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 de opção true Prefira a opção is null
false Prefira utilizar o método de igualdade por 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 única violação, adicione diretivas de pré-processador ao arquivo de origem para desativar e, em seguida, reativar 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 para um arquivo, pasta ou projeto, defina sua gravidade 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, consulte Como suprimir avisos de análise de código.

Ver também