CA1512: ArgumentOutOfRangeException throw 도우미 사용

속성 값
규칙 ID CA1512
제목 ArgumentOutOfRangeException throw 헬퍼 함수 사용
범주 유지 관리
수정 사항이 호환성을 깨뜨리는지 여부 또는 무중단인지 여부 끊기지 않는
.NET 10에서 기본적으로 사용하도록 설정 제안 사항
적용 가능한 언어 C# 및 Visual Basic

원인

코드는 인수가 지정된 값보다 작거나 큰지 확인한 다음 조건부로 ArgumentOutOfRangeExceptionthrow합니다.

규칙 설명

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

예시

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

void M(int arg)
{
    if (arg is 0)
        throw new ArgumentOutOfRangeException(nameof(arg));
    if (arg < 0)
        throw new ArgumentOutOfRangeException(nameof(arg));
    if (arg <= 0)
        throw new ArgumentOutOfRangeException(nameof(arg));
    if (arg <= 42)
        throw new ArgumentOutOfRangeException(nameof(arg));
    if (arg < 42)
        throw new ArgumentOutOfRangeException(nameof(arg));
    if (arg > 42)
        throw new ArgumentOutOfRangeException(nameof(arg));
    if (arg >= 42)
        throw new ArgumentOutOfRangeException(nameof(arg));
    if (arg == 42)
        throw new ArgumentOutOfRangeException(nameof(arg));
    if (arg != 42)
        throw new ArgumentOutOfRangeException(nameof(arg));
}

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

void M(int arg)
{
    ArgumentOutOfRangeException.ThrowIfZero(arg);
    ArgumentOutOfRangeException.ThrowIfNegative(arg);
    ArgumentOutOfRangeException.ThrowIfNegativeOrZero(arg);
    ArgumentOutOfRangeException.ThrowIfLessThanOrEqual(arg, 42);
    ArgumentOutOfRangeException.ThrowIfLessThan(arg, 42);
    ArgumentOutOfRangeException.ThrowIfGreaterThan(arg, 42);
    ArgumentOutOfRangeException.ThrowIfGreaterThanOrEqual(arg, 42);
    ArgumentOutOfRangeException.ThrowIfEqual(arg, 42);
    ArgumentOutOfRangeException.ThrowIfNotEqual(arg, 42);
}

위반 문제를 해결하는 방법

예외를 발생시키는 if 블록을 다음 throw-helper 메서드 중 하나를 호출하도록 바꿉니다.

또는 Visual Studio에서 전구 메뉴를 사용하여 코드를 자동으로 수정합니다.

경고를 표시하지 않는 경우

코드의 유지 관리가 중요하지 않다면 이 규칙 위반을 무시해도 안전합니다. 가양성으로 식별된 위반을 중지해도 괜찮습니다.

경고 표시 안 함

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

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

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

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

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

  • Last updated on