Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
| Propiedad | Valor |
|---|---|
| ID de regla | IDE0302 |
| Título | Uso de la expresión de colección para stackalloc |
| 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 es similar a Usar expresión de colección para la matriz (IDE0300), excepto que busca stackalloc en lugar de matrices. Al igual que IDE0300, ofrece convertir el código para usar una expresión de colección. Por ejemplo, stackalloc int[] { ... } y stackalloc [] { ... } se simplifican para [...].
Nota
Esta regla solo está disponible en .NET 8 y versiones posteriores, donde los valores se pueden conservar en la pila.
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 |
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.
El valor de when_types_loosely_match no se aplica a esta regla IDE0302, pero se muestra aquí por completitud de la opción dotnet_style_prefer_collection_expression (que comparten varias reglas). El valor predeterminado es efectivamente true.
Ejemplo
// Code with violations.
ReadOnlySpan<int> x = stackalloc int[] { 1, 2, 3 };
// Fixed code.
ReadOnlySpan<int> x = [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 IDE0302
// The code that's violating the rule is on this line.
#pragma warning restore IDE0302
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.IDE0302.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 Cómo suprimir advertencias de análisis de código.