CA1829: Enumerable.Count 메서드 대신 Length/Count 속성을 사용합니다.

속성	값
규칙 ID	CA1829
제목	Enumerable.Count 메서드 대신 Length/Count 속성을 사용하세요.
범주	성능
수정 사항이 호환성을 깨뜨리는지 여부 또는 무중단인지 여부	주요 변경 아님
.NET 10에서 기본적으로 사용하도록 설정	제안 사항
적용 가능한 언어	C# 및 Visual Basic

원인

Count LINQ 메서드가 동등하지만 더욱 효율적인 Length 또는 Count 속성을 지원하는 형식에서 사용되었습니다.

규칙 설명

이 규칙은 동일한 데이터를 가져오는 동등하지만 더욱 효율적인 Count 또는 Length 속성을 갖는 형식 컬렉션에서의 Count LINQ 메서드 호출에 플래그를 지정합니다. Length 또는 Count 속성은 컬렉션을 열거하지 않으므로 더욱 효율적입니다.

이 규칙은 Count 속성을 갖는 다음 컬렉션 형식에서의 Length 호출에 플래그를 지정합니다.

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

이 규칙은 Count 속성을 갖는 다음 컬렉션 형식에서의 Count 호출에 플래그를 지정합니다.

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

분석된 컬렉션 형식은 나중에 더 많은 사례를 포함하도록 확장될 수 있습니다.

위반 문제를 해결하는 방법

위반 문제를 해결하려면 Count 메서드 호출을 Length 또는 Count 속성 액세스 사용으로 바꾸세요. 예를 들어 다음 두 코드 조각은 규칙의 위반과 위반을 해결하는 방법을 보여 줍니다.

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

팁

Visual Studio에서는 이 규칙에 대한 코드 수정 사항을 사용할 수 있습니다. 이를 사용하려면 위반에 커서를 놓고 Ctrl+. (마침표) 키를 누르세요. 옵션 목록이 표시되면 사용 가능한 경우 Count() 대신 Length/Count 속성을 사용을 선택합니다.

경고를 표시하지 않는 경우

개수를 계산하기 위한 불필요한 컬렉션 열거가 성능에 미치는 영향을 고려하지 않아도 되는 경우 이 규칙의 위반을 표시하지 않아도 됩니다.

경고 표시 안 함

단일 위반을 억제하려면 원본 파일에 전처리기 지시문을 추가하여 규칙을 비활성화한 후 다시 활성화하십시오.

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

파일, 폴더 또는 프로젝트에 대한 규칙을 사용하지 않으려면 구성 파일에서 none의 심각도를 설정합니다.

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

자세한 내용은 방법: 코드 분석 경고 표시 안 함을 참조하세요.

관련 규칙

• CA1826: Linq 열거 가능 메서드 대신 속성 사용
• CA1827: Any를 사용할 수 있는 경우 Count/LongCount를 사용하지 마세요.
• CA1828: AnyAsync를 사용할 수 있는 경우 CountAsync/LongCountAsync를 사용하지 마세요.

참고하기

• 성능 규칙