Compartir vía

Usar la expresión de colección para nuevo (IDE0306)

Propiedad Importancia
Identificador de la regla IDE0306
Título Usar la expresión de colección para nuevo
Categoría Estilo
- Subcategoría Reglas de lenguaje (preferencias de nivel de expresión)
idiomas aplicables C# 12+
Opciones dotnet_style_prefer_collection_expression

Información general

Esta regla marca lugares donde se podría usar una expresión de colección con un elemento de propagación (..) para inicializar una lista en lugar de new. Por ejemplo, esta regla ofrece simplificar el código como new List<...>(x) en el formulario de expresión de colección ([.. x]).

Opciones

Las opciones especifican el comportamiento que desea 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 Desactiva 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.
List<int> l1 = new List<int>(Enumerable.Range(1, 10));
List<int> m1 = new List<int>(new[] { 1, 2, 3 });

// Fixed code.
List<int> l1 = [.. Enumerable.Range(1, 10)];
List<int> m1 = [.. new[] { 1, 2, 3 }];

Supresión de 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 IDE0306
// The code that's violating the rule is on this line.
#pragma warning restore IDE0306

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.IDE0306.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 Procedimiento para suprimir advertencias de análisis de código.

Consulte también

  • Last updated on