CA1836: Preferencia de IsEmpty sobre Count si está disponible

Causa

La propiedad Count o Length, o el método de extensión Count<TSource>(IEnumerable<TSource>) se utilizó para determinar si el objeto contiene o no elementos comparando el valor con 0 o 1 y el objeto tiene una propiedad IsEmpty más eficaz que podría usarse alternativamente.

Descripción de la regla

Esta regla marca las llamadas a las propiedades Count y Length o a los métodos LINQ Count<TSource>(IEnumerable<TSource>) y LongCount<TSource>(IEnumerable<TSource>) cuando se usan para determinar si el objeto contiene elementos y el objeto tiene una propiedad IsEmpty más eficaz.

El análisis de esta regla se superpone originalmente con las reglas similares CA1827, CA1828 y CA1829; los analizadores de dichas reglas se combinaron junto con el de CA1836 para notificar el mejor diagnóstico en caso de superposición.

Cómo corregir infracciones

Para corregir una infracción, reemplace la llamada al método Count<TSource>(IEnumerable<TSource>) o LongCount<TSource>(IEnumerable<TSource>) o el acceso a la propiedad Length o Count cuando se usa en una operación que determina si el objeto está vacío con el uso del acceso a la propiedad IsEmpty. 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.Concurrent;

class C
{
    ConcurrentQueue<int> _queue;
    public bool IsEmpty => _queue.Count == 0;
}

using System.Collections.Concurrent;

class C
{
    ConcurrentQueue<int> _queue;
    public bool IsEmpty => _queue.IsEmpty;
}

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

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

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

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