Usar la expresión de colección para el generador (IDE0304)
| 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 optan por el patrón collection-expression.
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 8when_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.
