Compartilhar via


Usar padrões correspondentes para evitar a verificação 'is' seguida por uma conversão (IDE0020 e IDE0038)

Este artigo descreve duas regras relacionadas, IDE0020 e IDE0038.

Propriedade Valor
ID da regra IDE0020
Título Usar padrões correspondentes para evitar a verificação is seguida por uma conversão (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 Usar padrões correspondentes para evitar a verificação 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

Essa regra de estilo refere-se ao uso de padrões correspondentes C#, por exemplo, o is int i, em vez de uma verificação is seguida por uma conversão, por exemplo, if (o is int) { ... (int)o ... }. Habilite IDE0020 ou IDE0038 com base em se a expressão de conversão deve ou não ser salva em uma variável local separada:

  • IDE0020: a expressão de conversão é salva em uma 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 conversão não é salva em uma 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 à essa regra para especificar se os padrões correspondentes ou a verificação is seguida por uma conversão de tipo é preferencial.

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

csharp_style_pattern_matching_over_is_with_cast_check

Propriedade Valor Descrição
Nome da opção csharp_style_pattern_matching_over_is_with_cast_check
Valores das opções true Prefira a correspondência de padrões a expressões is com conversões de tipo.
false Desabilita a regra.
valor de 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 seu arquivo de origem para desabilitar e depois reabilitar 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 de um arquivo, pasta ou projeto, defina sua severidade 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 para 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.

Consulte também