CA1829: Usar la propiedad Length/Count en lugar del método Enumerable.Count

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

Causa

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

Descripción de la regla

Esta regla marca las llamadas al método LINQ Count en colecciones de tipos que tienen la propiedad equivalente, pero más eficaz, Length o Count para capturar los mismos datos. La propiedad Length o Count no enumera la colección, por lo que es más eficaz.

Esta regla marca las llamadas Count en los siguientes tipos de colección con la propiedad Length:

• System.Array
• System.Collections.Immutable.ImmutableArray<T>

Esta regla marca las llamadas Count en los siguientes tipos de colección con la propiedad Count:

• System.Collections.ICollection
• System.Collections.Generic.ICollection<T>
• System.Collections.Generic.IReadOnlyCollection<T>

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

Cómo corregir infracciones

Para corregir una infracción, reemplace la llamada al método Count por el uso del acceso de la propiedad Length o Count. Por ejemplo, en los dos fragmentos de código siguientes se muestra una infracción de la regla y cómo corregirla:

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

class C
{
    public int GetCount(int[] array)
        => array.Count();

    public int GetCount(ICollection<int> collection)
        => collection.Count();
}

using System.Collections.Generic;

class C
{
    public int GetCount(int[] array)
        => array.Length;

    public int GetCount(ICollection<int> collection)
        => collection.Count;
}

Sugerencia

Hay disponible una corrección de código para esta regla en Visual Studio. Para poder usarla, coloque el cursor sobre la infracción y presione Ctrl+. (punto). Elija Usar la propiedad Length/Count en lugar de Count() cuando esté disponible en la lista de opciones que se muestra.

Cuándo suprimir las advertencias

Se puede suprimir una infracción de esta regla si no le preocupa el impacto en el rendimiento de la enumeración de recopilaciones innecesaria para calcular el recuento.

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

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.CA1829.severity = none

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

Reglas relacionadas

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

Vea también

• Reglas de rendimiento