CA1829: Use a propriedade Length/Count em vez do método Enumerable.Count

Motivo

O Count método LINQ foi usado em um tipo que suporta um equivalente, mais eficiente Length ou Count propriedade.

Descrição da regra

Esta regra sinaliza o Count método LINQ chama coleções de tipos que têm equivalente, mas mais eficiente Length ou Count propriedade para buscar os mesmos dados. Length ou Count propriedade não enumera a coleção, portanto, é mais eficiente.

Esta regra sinaliza chamadas nos seguintes tipos de Count coleção com Length propriedade:

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

Esta regra sinaliza chamadas nos seguintes tipos de Count coleção com a Count propriedade:

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

Os tipos de coleta analisados podem ser estendidos no futuro para abranger mais casos.

Como corrigir violações

Para corrigir uma violação, substitua a Count chamada de método pelo uso do ou acesso à Length Count propriedade. Por exemplo, os dois trechos de código a seguir mostram uma violação da regra e como corrigi-la:

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

Quando suprimir avisos

É seguro suprimir uma violação dessa regra se você não estiver preocupado com o impacto no desempenho da enumeração de coleta desnecessária para calcular a contagem.

Suprimir um aviso

Se você quiser apenas suprimir uma única violação, adicione diretivas de pré-processador ao seu arquivo de origem para desativar e, em seguida, reativar a regra.

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

Para desabilitar a regra de um arquivo, pasta ou projeto, defina sua gravidade como none no arquivo de configuração.

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

Para obter mais informações, consulte Como suprimir avisos de análise de código.

Regras conexas

• CA1826: Use a propriedade em vez do método Linq Enumerable
• CA1827: Não use Count/LongCount quando algum pode ser usado
• CA1828: Não use CountAsync/LongCountAsync quando AnyAsync pode ser usado

Consulte também

• Regras de desempenho