CA1836: Preferencia de IsEmpty sobre Count si está disponible

Propiedad	Value
Identificador de la regla	CA1836
Título	Preferencia de IsEmpty sobre Count si está disponible
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

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;
}

Sugerencia

Hay disponible una corrección de código para esta regla en Visual Studio. Para usarlo, coloque el cursor sobre la infracción y presione Ctrl+. (punto). Elija Prefer 'IsEmpty' over 'Count' to determine whether the object contains or not any items (Preferir 'IsEmpty' sobre 'Count' para determinar si el objeto contiene o no elementos) 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 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