Partilhar via


A verificação nula pode ser simplificada (IDE0029, IDE0030 e IDE0270)

Este artigo descreve três regras relacionadas, IDE0029, IDE0030e IDE0270.

Propriedade Valor
ID da Regra IDE0029
Título A verificação nula pode ser simplificada (verificação condicional ternary)
Categoria Estilo
Subcategoria Regras de linguagem (preferências ao nível da expressão)
Idiomas aplicáveis C# e Visual Basic
Opções dotnet_style_coalesce_expression
Propriedade Valor
ID da Regra IDE0030
Título A verificação nula pode ser simplificada (verificação condicional ternary anulável)
Categoria Estilo
Subcategoria Regras de linguagem (preferências ao nível da expressão)
Idiomas aplicáveis C# e Visual Basic
Opções dotnet_style_coalesce_expression
Propriedade Valor
ID da Regra IDE0270
Título A verificação nula pode ser simplificada (se for verificada de forma nula)
Categoria Estilo
Subcategoria Regras de linguagem (preferências ao nível da expressão)
Idiomas aplicáveis C# e Visual Basic
Opções dotnet_style_coalesce_expression

Descrição Geral

As regras IDE0029 e IDE0030 dizem respeito à utilização de expressões de agrupamento nulo, por exemplo, x ?? y, versus expressões condicionais ternary com null verificações, por exemplo, x != null ? x : y. As regras diferem em relação à nulobilidade das expressões:

  • IDE0029: utilizado quando estão envolvidas expressões não anuláveis. Por exemplo, esta regra pode recomendar x ?? y em vez de x != null ? x : y quando x e y são tipos de referência não anuláveis.
  • IDE0030: utilizado quando estão envolvidas expressões anuláveis. Por exemplo, esta regra pode recomendar x ?? y em vez de quando x e y são tipos de x != null ? x : yvalores anuláveis ou tipos de referência anuláveis.

A regra IDE0270 sinaliza a utilização de uma verificação nula (== null ou is null) em vez do operador null-coalescing (??).

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_coalesce_expression

Propriedade Valor Descrição
Nome da opção dotnet_style_coalesce_expression
Valores de opção true Prefere expressões de agrupamento nulo.
false Desativa a regra.
Valor de opção predefinido true

Exemplos

IDE0029 e IDE0030

// Code with violation.
var v = x != null ? x : y; // or
var v = x == null ? y : x;

// Fixed code.
var v = x ?? y;
' Code with violation.
Dim v = If(x Is Nothing, y, x) ' or
Dim v = If(x IsNot Nothing, x, y)

' Fixed code.
Dim v = If(x, y)

IDE0270

// Code with violation.
class C
{
    void M()
    {
        var item = FindItem() as C;
        if (item == null)
            throw new System.InvalidOperationException();
    }

    object? FindItem() => null;
}

// Fixed code (dotnet_style_coalesce_expression = true).
class C
{
    void M()
    {
        var item = FindItem() as C ?? throw new System.InvalidOperationException();
    }

    object? FindItem() => null;
}
' Code with violation.
Public Class C
    Sub M()
        Dim item = TryCast(FindItem(), C)
        If item Is Nothing Then
            item = New C()
        End If
    End Sub

    Function FindItem() As Object
        Return Nothing
    End Function
End Class

' Fixed code (dotnet_style_coalesce_expression = true).
Public Class C
    Sub M()
        Dim item = If(TryCast(FindItem(), C), New C())
    End Sub

    Function FindItem() As Object
        Return Nothing
    End Function
End Class

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 IDE0029 // Or IDE0030 or IDE0270
// The code that's violating the rule is on this line.
#pragma warning restore IDE0029 // Or IDE0030 or IDE0270

Para desativar a regra para um ficheiro, pasta ou projeto, defina a sua gravidade como none no ficheiro de configuração.

[*.{cs,vb}]
dotnet_diagnostic.IDE0029.severity = none
dotnet_diagnostic.IDE0030.severity = none
dotnet_diagnostic.IDE0270.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