Usar la expresión de colección para el generador (IDE0304)

2025-04-24

Propiedad	Importancia
ID de regla	IDE0304
Título	Usar la expresión de colección para el generador
Categoría	Estilo
Subcategoría	Reglas del lenguaje (preferencias de nivel de expresión)
Idiomas aplicables	C# 12+
Opciones	`dotnet_style_prefer_collection_expression`

Información general

Esta regla marca dónde se llama a un método CreateBuilder() o similar para crear un tipo de generador que agrega elementos y, por último, construye un tipo de colección que tiene el atributo CollectionBuilderAttribute (por ejemplo, llamando a ImmutableArray<T>.Builder.ToImmutable()). En su lugar, se podría usar una expresión de colección ([...]) para inicializar la colección.

Nota:

Esta regla requiere versiones más recientes de las API inmutables (por ejemplo, System.Collections.Immutable), que optan por el patrón collection-expression.

Opciones

Las opciones especifican el comportamiento que se quiere que aplique la regla. Para obtener información sobre cómo configurar opciones, vea Formato de opción.

dotnet_style_prefer_collection_expression

Propiedad	Importancia	Descripción
Nombre de opción	dotnet_style_prefer_collection_expression
Valores de opción	`true` \| `when_types_exactly_match`	Prefiere usar expresiones de colección solo cuando los tipos coinciden exactamente, por ejemplo, `List<int> list = new List<int>() { 1, 2 };`.
	`when_types_loosely_match`*	Prefiere usar expresiones de colección incluso cuando los tipos coinciden de forma flexible, por ejemplo, `IEnumerable<int> list = new List<int>() { 1, 2 };`. El tipo de destino debe coincidir con el tipo en el lado derecho o ser uno de los siguientes tipos: IEnumerable<T>, ICollection<T>, IList<T>, IReadOnlyCollection<T>, IReadOnlyList<T>.
	`false` \| `never`	Deshabilita la regla.
Valor de opción predeterminado	`when_types_loosely_match`*

*Cuando se usa esta opción, la corrección de código podría cambiar la semántica del código.

Ejemplo

// Code with violation.
var builder = ImmutableArray.CreateBuilder<int>();
builder.Add(1);
builder.AddRange(new int[] { 5, 6, 7 });
ImmutableArray<int> i = builder.ToImmutable();

// Fixed code.
ImmutableArray<int> i = [1, .. new int[] { 5, 6, 7 }];

Supresión de una advertencia

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

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

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

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

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

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

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

Compartir a través de