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

  • Artigo

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 linguagem (preferências de padrões correspondentes)
Linguagens 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 linguagem (preferências de padrões correspondentes)
Linguagens 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 dependendo se a expressão de conversão deverá 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, se 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 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 as opções, consulte Formato da 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 da opção true Prefira a correspondência de padrões a expressões is com conversões de tipo.
false Desabilita 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 violação, adicione diretivas de pré-processador ao arquivo de origem para desabilitar e, em seguida, reabilite 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 em um arquivo, uma pasta ou um projeto, defina a 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 como none no arquivo de configuração.

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

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

Confira também