Share via

Utilizar a verificação "é nula" (IDE0041)

  • Artigo
Propriedade Valor
ID da Regra IDE0041
Título Utilizar a verificação "é nulo"
Categoria Estilo
Subcategoria Regras de idioma (preferências ao 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

Descrição Geral

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

Opções

As opções especificam o comportamento que pretende que a regra aplique. Para obter informações sobre como configurar opções, veja 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 Preferir is null verificação
false Preferir o método de igualdade de referência
Valor de opção predefinido 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 quiser suprimir apenas uma única violação, adicione diretivas de pré-processamento ao ficheiro 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 desativar a regra de um ficheiro, pasta ou projeto, defina a gravidade para none no ficheiro de configuração.

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

Para desativar todas as regras de estilo de código, defina a gravidade da categoria Style como none no ficheiro de configuração.

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

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

Ver também