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, 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 8when_types_loosely_match en .NET 9 y versiones posteriores |
*La corrección de código cuando se usa esta opción 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.
