Partilhar via


Use combinação de padrões para evitar a verificação 'is' seguida por um cast (IDE0020 e IDE0038)

Este artigo descreve duas regras relacionadas, IDE0020 e IDE0038.

Propriedade Valor
ID da regra IDE0020
Título Use uma correspondência de padrão para evitar a verificação is seguida de um casting (com variável)
Categoria Estilo
Subcategoria Regras de idioma (preferências de correspondência de padrões)
Idiomas aplicáveis C#
Opções csharp_style_pattern_matching_over_is_with_cast_check
Propriedade Valor
ID da regra IDE0038
Título Utilize correspondência de padrões para evitar a verificação de is seguida por uma conversão (sem variável)
Categoria Estilo
Subcategoria Regras de idioma (preferências de correspondência de padrões)
Idiomas aplicáveis C#
Opções csharp_style_pattern_matching_over_is_with_cast_check

Visão geral

Esta regra de estilo diz respeito ao uso de correspondência de padrões em C# , por exemplo, o is int i, em vez de uma verificação de is seguida por uma conversão, por exemplo, if (o is int) { ... (int)o ... }. Habilite IDE0020 ou IDE0038 com base no fato de a expressão de conversão dever ou não ser salva em uma variável local separada:

  • IDE0020: A expressão de cast é guardada numa variável local. Por exemplo, if (o is int) { var i = (int)o; } salva o resultado de (int)o em uma variável local.
  • IDE0038: A expressão de 'cast' não está guardada numa variável local. Por exemplo, if (o is int) { if ((int)o == 1) { ... } } não salva o resultado de (int)o em uma variável local.

Opções

Defina o valor da opção associada para esta regra para especificar se a correspondência de padrões ou a verificação is seguida de uma conversão de tipo é preferível.

Para obter mais informações sobre como configurar opções, consulte Formato de opção.

estilo_csharp_matching_de_padrões_sobre_é_com_verificação_de_elenco

Propriedade Valor Descrição
Nome da opção estilo_csharp_correspondência_de_padrões_sobre_é_com_verificação_de_conversão
Valores de opção true Prefira a correspondência de padrões em vez de expressões is com moldes de texto.
false Desativa a regra.
Valor da opção padrão true
// csharp_style_pattern_matching_over_is_with_cast_check = true
if (o is int i) {...}

// csharp_style_pattern_matching_over_is_with_cast_check = false
if (o is int) {var i = (int)o; ... }

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

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

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