Share via

CA1826: Linq 열거 가능 메서드 대신 속성 사용

  • 아티클
속성 값
규칙 ID CA1826
타이틀 Linq Enumerable 메서드 대신 속성을 사용하세요.
범주 성능
수정 사항이 주요 변경인지 여부 주요 변경 아님
.NET 8에서 기본적으로 사용 제안 사항

원인

Enumerable LINQ 메서드가 보다 효율적인 동등한 속성을 지원하는 형식에서 사용되었습니다.

규칙 설명

이 규칙은 동일한 데이터를 페치하기 위해 동일하지만 더 효율적인 속성을 가진 형식의 컬렉션에 대해 LINQ 메서드 호출에 플래그 Enumerable 를 지정합니다.

이 규칙은 구현하지만 그렇지 IReadOnlyList<T> 않은 IList<T>컬렉션 형식을 분석합니다.

이 규칙은 이러한 컬렉션 형식에 대해 다음 메서드에 대한 호출에 플래그를 지정합니다.

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

위반 문제를 해결하는 방법

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

using System;
using System.Collections.Generic;
using System.Linq;

class C
{
    public void M(IReadOnlyList<string> list)
    {
        Console.Write(list.First());
        Console.Write(list.Last());
        Console.Write(list.Count());
    }
}

using System;
using System.Collections.Generic;

class C
{
    public void M(IReadOnlyList<string> list)
    {
        Console.Write(list[0]);
        Console.Write(list[list.Count - 1]);
        Console.Write(list.Count);
    }
}

팁

Visual Studio에서는 이 규칙에 대한 코드 수정 사항을 사용할 수 있습니다. 이를 사용하려면 위반에 커서를 놓고 Ctrl+ 키를 누릅니다.(마침표). 옵션 목록이 표시되면 인덱서 사용을 선택합니다.

Code fix for CA1826 - Use indexer

경고를 표시하지 않는 경우

특정 Enumerable 메서드 호출이 성능에 미치는 영향이 중요하지 않은 경우 이 규칙의 위반을 표시하지 않아도 됩니다.

경고 표시 안 함

단일 위반만 표시하지 않으려면 원본 파일에 전처리기 지시문을 추가하여 규칙을 사용하지 않도록 설정한 후 다시 사용하도록 설정합니다.

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

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

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

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

분석할 코드 구성

다음 옵션을 사용하여 이 규칙이 실행될 코드베이스 부분을 구성합니다.

FirstOrDefault 및 LastOrDefault 메서드 제외

분석에서 메서드 및 Enumerable.LastOrDefault 메서드를 Enumerable.FirstOrDefault 제외하도록 이 규칙을 구성할 수 있습니다. 가독성이 중요한 경우 이러한 메서드를 바꾸기 위해 작성하는 코드를 쉽게 읽을 수 없으므로 이러한 메서드를 제외하는 것이 좋습니다. 이러한 메서드를 제외하려면 프로젝트의 .editorconfig 파일에 다음 키-값 쌍을 추가합니다.

dotnet_code_quality.CA1826.exclude_ordefault_methods = true

참고 항목