Compartir vía

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

Propiedad Valor
Identificador de la regla IDE0300
Título Uso de la expresión de colección para matrices
Categoría Estilo
Subcategoría Reglas de lenguaje (preferencias de nivel de expresión)
idiomas aplicables C# 12+
Opciones dotnet_style_prefer_collection_expression

Visió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 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 Valor 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.

Por ejemplo, si hubieras tenido IEnumerable<int> x = new int[] { 1, 2, 3 };, entonces en el código original se produciría una matriz. Pero en el nuevo código (IEnumerable<int> x = [1, 2, 3];), se genera en su lugar un tipo sintetizado por el compilador interno. 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];

Suprimir 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 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 en el archivo de configuración de .

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

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

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

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

Consulte también

  • Last updated on