Preferências 'var' (IDE0007 e IDE0008)

2025-02-11

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 idioma (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	Usar o tipo explícito em vez de `var`
Categoria	Estilo
Subcategoria	Regras de idioma (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 a palavra-chave var ou um tipo explícito deve ser usada em uma declaração de variável. Para garantir que var seja usado, defina a gravidade de IDE0007 como aviso ou erro. Para impor que o tipo explícito seja usado, defina a gravidade de IDE0008 como aviso ou erro.

Opções

As opções associadas a essa 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 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 das opções	`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 de 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 das opções	`true`	Prefira `var` quando o tipo já for mencionado no lado direito de uma expressão de declaração
	`false`	Prefira o tipo explícito quando o tipo já for mencionado no lado direito de uma expressão de declaração
valor de 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 das opções	`true`	Prefira `var` em vez de 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 de 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 desabilitar a regra e, depois, reabilitá-la.

#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 de um arquivo, pasta ou projeto, defina sua 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 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.

Compartilhar via