CA1826: Usar la propiedad en lugar del método Linq Enumerable

Propiedad	Value
Identificador de la regla	CA1826
Título	Usar la propiedad en lugar del método Linq Enumerable
Categoría	Rendimiento
La corrección es problemática o no problemática	Poco problemático
Habilitado de forma predeterminada en .NET 9	Como sugerencia

Causa

El método Enumerable de LINQ se ha usado en un tipo que admite una propiedad equivalente y más eficaz.

Descripción de la regla

Esta regla marca las llamadas al método LINQ Enumerable en colecciones de tipos que tienen propiedades equivalentes pero más eficientes para capturar los mismos datos.

Esta regla analiza los tipos de colección que implementan IReadOnlyList<T>, pero no IList<T>.

Esta regla marca las llamadas a los siguientes métodos en estos tipos de colección:

• System.Linq.Enumerable.Count
• System.Linq.Enumerable.First
• System.Linq.Enumerable.FirstOrDefault
• System.Linq.Enumerable.Last
• System.Linq.Enumerable.LastOrDefault

Los tipos y métodos de colección analizados pueden ampliarse en el futuro para cubrir más casos.

Cómo corregir infracciones

Para corregir una infracción, sustituya la llamada de método Enumerable por acceso de propiedad. Por ejemplo, en los dos fragmentos de código siguientes se muestra una infracción de la regla y cómo corregirla:

C#

using System;
using System.Collections.Generic;
using System.Linq;

class C
{
    public void M(IReadOnlyList<string> list)
    {
        Console.Write(list.First());
        Console.Write(list.Last());
        Console.Write(list.Count());
    }
}

C#

using System;
using System.Collections.Generic;

class C
{
    public void M(IReadOnlyList<string> list)
    {
        Console.Write(list[0]);
        Console.Write(list[list.Count - 1]);
        Console.Write(list.Count);
    }
}

Sugerencia

Hay disponible una corrección de código para esta regla en Visual Studio. Para usarla, coloque el cursor sobre la infracción y presione Ctrl+. (punto). Elija Usar el indizador en la lista de opciones que se presentan.

Cuándo suprimir las advertencias

Se puede suprimir una infracción de esta regla si no le preocupa el impacto en el rendimiento de las llamadas de método Enumerable específicas.

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.

C#

#pragma warning disable CA1826
// The code that's violating the rule is on this line.
#pragma warning restore CA1826

Para deshabilitar la regla de un archivo, una carpeta o un proyecto, establezca su gravedad en none del archivo de configuración.

ini

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

Para obtener más información, consulte Procedimiento para suprimir advertencias de análisis de código.

Configuración del código para analizar

Use la opción siguiente para configurar en qué partes del código base ejecutar esta regla.

• Exclusión de los métodos FirstOrDefault y LastOrDefault

Exclusión de los métodos FirstOrDefault y LastOrDefault

Puede configurar esta regla para excluir los métodos Enumerable.FirstOrDefault y Enumerable.LastOrDefault del análisis. Puede considerar la posibilidad de excluir estos métodos si la legibilidad es un problema, ya que el código que escribiría para reemplazarlos no es fácil de leer. Para excluir estos métodos, agregue el siguiente par clave-valor a un archivo .editorconfig en el proyecto:

ini

dotnet_code_quality.CA1826.exclude_ordefault_methods = true

Reglas relacionadas

• CA1827: No usar Count/LongCount si se puede usar Any
• CA1828: No usar CountAsync/LongCountAsync si se puede usar AnyAsync
• CA1829: Usar la propiedad Length/Count en lugar del método Enumerable.Count

Vea también

• Reglas de rendimiento