CA1511: ArgumentException throw 도우미 사용

속성	값
규칙 ID	CA1511
제목	ArgumentException throw 도우미 사용
범주	유지 관리
수정 사항이 주요 변경인지 여부	작업을 중단하지 않는 변경
.NET 9에서 기본적으로 사용	제안 사항

원인

코드는 null 인수가 빈 문자열인지 여부를 확인한 다음 조건부로 ArgumentException을 throw합니다.

규칙 설명

인수 검사는 코드 크기에 상당한 영향을 미치며 작은 함수 및 속성 setter에 대한 코드를 지배하는 경우가 많습니다. 이러한 검사는 인라인을 방지하고 상당한 명령 캐시 오염을 유발합니다. 이와 같은 ArgumentException.ThrowIfNullOrEmpty(String, String) Throw 도우미 메서드는 새 예외 인스턴스를 생성하는 블록보다 if 더 간단하고 효율적입니다.

예시

다음 코드 조각은 CA1511 위반을 보여줍니다.

void M(string arg)
{
    if (string.IsNullOrEmpty(arg))
        throw new ArgumentException("", "arg");
}

다음 코드 조각은 수정 사항을 보여줍니다.

void M(string arg)
{
    ArgumentException.ThrowIfNullOrEmpty(arg);
}

위반 문제를 해결하는 방법

예외를 if throw하는 블록을 호출로 ArgumentException.ThrowIfNullOrEmpty(String, String)바꿉니다. 또는 Visual Studio에서 전구 메뉴를 사용하여 코드를 자동으로 수정합니다.

경고를 표시하지 않는 경우

코드의 유지 관리가 중요하지 않은 경우 이 규칙의 위반을 표시하지 않아도 됩니다. 가양성으로 식별된 위반을 중지해도 괜찮습니다.

경고 표시 안 함

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

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

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

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

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