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 9 | 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
