CA2261: ConfigureAwaitOptions.SuppressThrowing와 Task<TResult>를 사용하지 마세요.

속성	값
규칙 ID	CA2261
제목	ConfigureAwaitOptions.SuppressThrowing을 Task<TResult>와 함께 사용 안 함
범주	사용 현황
수정 사항이 호환성을 깨뜨리는지 여부 또는 무중단인지 여부	주요 변경 아님
.NET 10에서 기본적으로 사용하도록 설정	경고로서
적용 가능한 언어	C# 및 Visual Basic

원인

값 ConfigureAwaitOptions.SuppressThrowing가 Task<TResult>.ConfigureAwait(ConfigureAwaitOptions)에 전달됩니다.

규칙 설명

이 ConfigureAwaitOptions.SuppressThrowing 옵션은 제네릭 Task<TResult>에서 지원되지 않습니다. 이 경우 잘못된 TResult옵션이 반환될 수 있기 때문에 지원되지 않습니다. 이 규칙은 런타임이 아닌 빌드 시 오류를 표시하기 위해 사용하는 SuppressThrowingTask<TResult> 플래그를 지정합니다.

위반 문제를 해결하는 방법

Task<TResult>를 제네릭이 아닌 Task로 캐스팅한 후 ConfigureAwait(ConfigureAwaitOptions)를 호출합니다.

예시

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

Task<int> t = new Task<int>(() => 1);
t.ConfigureAwait(ConfigureAwaitOptions.SuppressThrowing);

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

Task<int> t = new Task<int>(() => 1);
((Task)t).ConfigureAwait(ConfigureAwaitOptions.SuppressThrowing);

오류를 억제해야 하는 경우

이 규칙의 경고를 숨기면 안 됩니다. 작업이 잘못되었거나 취소된 TResult 경우 유효하지 않으며 런타임 오류가 발생합니다.