Configurações de 'var' (IDE0007 e IDE0008)

Artigo
02/08/2025

Este artigo descreve duas regras relacionadas, IDE0007 e IDE0008.

Propriedade	Valor
ID da regra	IDE0007
Título	Use `var` em vez de tipo explícito
Categoria	Estilo
Subcategoria	Regras linguísticas (preferências 'var')
Idiomas 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	Use um tipo explícito em vez de `var`
Categoria	Estilo
Subcategoria	Regras linguísticas (preferências 'var')
Idiomas 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 o var palavra-chave ou um tipo explícito deve ser usado em uma declaração de variável. Para impor que o var seja usado, defina a gravidade do IDE0007 como aviso ou erro. Para impor que o tipo explícito seja usado, defina a gravidade do IDE0008 como aviso ou erro.

Opções

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

Tipos incorporados (csharp_style_var_for_built_in_types)
Locais onde o tipo é aparente (csharp_style_var_when_type_is_apparent)
Em outros lugares (csharp_style_var_elsewhere)

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

csharp_style_var_for_built_in_types

Propriedade	Valor	Descrição
Nome da opção	csharp_style_var_for_built_in_types
Valores de opção	`true`	Prefer `var` é usado 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 internos do sistema, 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;

estilo_csharp_var_quando_o_tipo_é_aparente

Propriedade	Valor	Descrição
Nome da opção	csharp_style_var_when_type_is_apparent
Valores de opção	`true`	Prefira `var` quando o tipo já é mencionado no lado direito de uma expressão de declaração
	`false`	Prefira o tipo explícito quando o tipo já é 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 de opção	`true`	Prefira `var` ao tipo explícito em todos os casos, a menos que seja substituído por outra regra de estilo de código
	`false`	Prefira o tipo explícito ao `var` em todos os casos, a menos que seja substituído 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 única violação, adicione diretivas de pré-processador ao arquivo de origem para desativar e, em seguida, reativar 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 para um arquivo, pasta ou projeto, defina sua gravidade 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, consulte Como suprimir avisos de análise de código.

Partilhar via