preferências de 'var' (IDE0007 e IDE0008)

Artigo
04/07/2023

Este artigo descreve duas regras relacionadas, IDE0007 e IDE0008.

Propriedade	Valor
ID da regra	IDE0007
Título	Usar `var` em vez do tipo explícito
Categoria	Estilo
Subcategoria	Regras de linguagem (preferências de 'var')
Linguagens aplicáveis	C#
Opções	`csharp_style_var_for_built_in_types`
	`csharp_style_var_when_type_is_apparent`
	`csharp_style_var_elsewhere`

Propriedade	Valor
ID da regra	IDE0008
Título	Usar o tipo explícito em vez de `var`
Categoria	Estilo
Subcategoria	Regras de linguagem (preferências de 'var')
Linguagens aplicáveis	C#
Opções	`csharp_style_var_for_built_in_types`
	`csharp_style_var_when_type_is_apparent`
	`csharp_style_var_elsewhere`

Visão geral

Essas duas regras de estilo definem se a palavra-chave var ou um tipo explícito deve ser usado em uma declaração de variável. Para impor o uso de var, defina a gravidade de IDE0007 como aviso ou erro. Para impor o uso do tipo específico, defina a gravidade de IDE0008 como aviso ou erro.

Opções

As opções associadas dessa regra definem onde essa preferência de estilo deve ser aplicada:

Tipos internos (csharp_style_var_for_built_in_types)
Locais em que o tipo é aparente (csharp_style_var_when_type_is_apparent)
Qualquer outro local (csharp_style_var_elsewhere)

Para obter mais informações sobre como configurar opções, consulte Formato para opções.

csharp_style_var_for_built_in_types

Propriedade	Valor	Descrição
Nome da opção	csharp_style_var_for_built_in_types
Valores da opção	`true`	Prefira o uso de `var` para declarar variáveis com tipos de sistema internos, como `int`
	`false`	Prefira o tipo explícito em vez de `var` para declarar variáveis com tipos de sistema internos, como `int`
Valor da opção padrão	`false`

// csharp_style_var_for_built_in_types = true
var x = 5;

// csharp_style_var_for_built_in_types = false
int x = 5;

csharp_style_var_when_type_is_apparent

Propriedade	Valor	Descrição
Nome da opção	csharp_style_var_when_type_is_apparent
Valores da opção	`true`	Prefira `var` quando o tipo já tiver sido mencionado no lado direito de uma expressão de declaração
	`false`	Prefira o tipo explícito quando o tipo já tiver sido mencionado no lado direito de uma expressão de declaração
Valor da opção padrão	`false`

// csharp_style_var_when_type_is_apparent = true
var obj = new Customer();

// csharp_style_var_when_type_is_apparent = false
Customer obj = new Customer();

csharp_style_var_elsewhere

Propriedade	Valor	Descrição
Nome da opção	csharp_style_var_elsewhere
Valores da opção	`true`	Prefira `var` em vez de tipo explícito em todos os casos, a menos que a regra seja substituída por outra regra de estilo de código
	`false`	Prefira o tipo explícito em vez de `var` em todos os casos, a menos haja substituição por outra regra de estilo de código
Valor da opção padrão	`false`

// csharp_style_var_elsewhere = true
var f = this.Init();

// csharp_style_var_elsewhere = false
bool f = this.Init();

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

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.IDE0007.severity = none
dotnet_diagnostic.IDE0008.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.