Preferencias de "var" (IDE0007 e IDE0008)

Artikulua
02/11/2025

En este artículo se describen dos reglas relacionadas, IDE0007 y IDE0008.

Propiedad	Valor
Identificador de la regla	IDE0007
Título	Usa `var` en lugar de un tipo explícito
Categoría	Estilo
Subcategoría	Reglas de idioma (preferencias "var")
idiomas aplicables	C#
Opciones	`csharp_style_var_for_built_in_types`
	`csharp_style_var_when_type_is_apparent`
	`csharp_style_var_elsewhere`

Propiedad	Valor
Identificador de la regla	IDE0008
Título	Uso de un tipo explícito en lugar de `var`
Categoría	Estilo
Subcategoría	Reglas de idioma (preferencias "var")
idiomas aplicables	C#
Opciones	`csharp_style_var_for_built_in_types`
	`csharp_style_var_when_type_is_apparent`
	`csharp_style_var_elsewhere`

Visión general

Estas dos reglas de estilo definen si se debe usar la palabra clave var o un tipo explícito en una declaración de variable. Para exigir que se use var, establezca la gravedad de IDE0007 en advertencia o error. Para exigir que se use el tipo explícito, configure la gravedad de IDE0008 como advertencia o error.

Opciones

Las opciones asociadas de esta regla definen dónde se debe aplicar esta preferencia de estilo:

Built-in types (csharp_style_var_for_built_in_types)
Lugares donde el tipo es aparente (csharp_style_var_when_type_is_apparent)
Elsewhere (csharp_style_var_elsewhere)

Para obtener más información sobre la configuración de opciones, vea Formato de opción.

csharp_style_var_for_built_in_types

Propiedad	Valor	Descripción
nombre de opción	csharp_style_var_for_built_in_types
Valores de opción	`true`	Se prefiere `var` para declarar variables con tipos de sistema integrados, como `int`
	`false`	Se prefiere el tipo explícito sobre `var` para declarar variables con tipos de sistema integrados, como `int`
valor de opción predeterminado	`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

Propiedad	Valor	Descripción
nombre de opción	csharp_style_var_when_type_is_apparent
Valores de opción	`true`	Se prefiere `var` cuando el tipo ya se mencione en el lado derecho de una expresión de declaración
	`false`	Preferir el tipo explícito cuando el tipo ya se mencione en el lado derecho de una expresión de declaración
valor de opción predeterminado	`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

Propiedad	Valor	Descripción
nombre de opción	csharp_style_var_elsewhere
Valores de opción	`true`	Se prefiere `var` a un tipo explícito en todos los casos, a menos que se reemplace por otra regla de estilo de código
	`false`	Se prefiere el tipo explícito en vez de `var` en todos los casos, a no ser que otra regla de estilo de código lo reemplace
valor de opción predeterminado	`false`

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

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

Suprimir una advertencia

Si desea suprimir solo una infracción, agregue directivas de preprocesador al archivo de origen para deshabilitar y volver a habilitar la regla.

#pragma warning disable IDE0007 // Or IDE0008
// The code that's violating the rule is on this line.
#pragma warning restore IDE0007 // Or IDE0008

Para deshabilitar la regla de un archivo, una carpeta o un proyecto, establezca su gravedad en none en el archivo de configuración de .

ini

[*.{cs,vb}]
dotnet_diagnostic.IDE0007.severity = none
dotnet_diagnostic.IDE0008.severity = none

Para deshabilitar todas las reglas de estilo del código, establezca la gravedad de la categoría Style en none del archivo de configuración.

ini

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

Para obtener más información, vea Cómo suprimir advertencias de análisis de código.

Partekatu honen bidez: