CA1510: ArgumentNullException throw 보조 함수 사용

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

원인

코드는 null 인수가 있는지 확인한 다음 조건부로 ArgumentNullException을 throw합니다.

규칙 설명

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

예시

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

void M(string arg)
{
    if (arg is null)
        throw new ArgumentNullException(nameof(arg));
}

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

void M(string arg)
{
    ArgumentNullException.ThrowIfNull(arg);
}

위반 문제를 해결하는 방법

예외를 발생시키는 if 블록을 ArgumentNullException.ThrowIfNull 호출로 교체합니다. 또는 Visual Studio에서 전구 메뉴를 사용하여 코드를 자동으로 수정합니다.

경고를 표시하지 않는 경우

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

경고 표시 안 함

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

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

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

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

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