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

  • Artículo
Propiedad Value
Identificador de la 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)
Lenguajes 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 opten por el patrón colección-expresión.

Opciones

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

dotnet_style_prefer_collection_expression

Propiedad Valor Descripción
Nombre de la 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.
when_types_loosely_match
(.NET 9 y versiones posteriores)*		 Prefiere usar expresiones de colección incluso cuando los tipos coinciden de forma flexible. 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 true en .NET 8
when_types_loosely_match en .NET 9 y versiones posteriores

*La corrección de código cuando se usa esta opción puede 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 gravedad en none del archivo de configuración.

[*.{cs,vb}]
dotnet_diagnostic.IDE0304.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.

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

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

Consulte también