CA1871: nullable 구조체를 'ArgumentNullException.ThrowIfNull'에 전달하지 마세요.

속성	값
규칙 ID	CA1871
제목	nullable 구조체를 'ArgumentNullException.ThrowIfNull'에 전달하지 마세요.
범주	성능
수정 사항이 주요 변경인지 여부	주요 변경 아님
.NET 9에서 기본적으로 사용	정보로

원인

nullable 구조체(예 int? : nullable 구조체) Guid?가 전달되면 ArgumentNullException.ThrowIfNull개체에 boxed되어 성능 저하가 발생합니다.

규칙 설명

성능 향상을 위해 nullable 구조체를 전달하는 것보다 속성을 검사 HasValue 수동으로 예외를 throw하는 ArgumentNullException.ThrowIfNull것이 좋습니다.

위반 문제를 해결하는 방법

null을 확인하고 수동으로 throw합니다 ArgumentNullException .

예시

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

static void Print(int? value)
{
    ArgumentNullException.ThrowIfNull(value);
    Console.WriteLine(value.Value);
}

다음 코드 조각은 이 위반을 해결합니다.

static void Print(int? value)
{
    if (!value.HasValue)
    {
        throw new ArgumentNullException(nameof(value));
    }

    Console.WriteLine(value.Value);
}

경고를 표시하지 않는 경우

성능이 중요하지 않은 경우 이 경고를 표시하지 않는 것이 안전합니다.

경고 표시 안 함

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

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

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

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

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