Uso de la expresión de colección para matrices (IDE0300)

  • Artículo
Propiedad Value
Identificador de la regla IDE0300
Título Uso de la expresión de colección para matrices
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 lugares donde se podría usar una expresión de colección para inicializar una matriz. Por ejemplo, esta regla ofrece simplificar código, como new C[] { ... }, new[] { ... } y C[] c = { ... }, en el formulario de expresión de colecció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, por ejemplo, int[] i = new int[] { 1, 2, 3 };.
when_types_loosely_match
(.NET 9 y versiones posteriores)*		 Prefiere usar expresiones de colección incluso cuando los tipos coinciden de forma flexible, por ejemplo, IEnumerable<int> i = new int[] { 1, 2, 3 };. 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. Por ejemplo, si tenía IEnumerable<int> x = new int[] { 1, 2, 3 };, en el código original, se genera una matriz. Pero en el nuevo código (IEnumerable<int> x = [1, 2, 3];), se genera en su lugar un tipo interno sintetizado por el compilador. Puede observar esta diferencia si usa una comprobación de is o una conversión.

Ejemplo

// Code with violations.
int[] i = new int[] { 1, 2, 3 };
IEnumerable<int> j = new int[] { 1, 2, 3 };

// Fixed code.
int[] i = [1, 2, 3];
IEnumerable<int> j = [1, 2, 3];

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

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.IDE0300.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