다음을 통해 공유


DbCommand.PrepareAsync(CancellationToken) 메서드

정의

데이터 소스에 대해 명령의 준비된(또는 컴파일된) 버전을 비동기적으로 만듭니다.

public virtual System.Threading.Tasks.Task PrepareAsync (System.Threading.CancellationToken cancellationToken = default);
abstract member PrepareAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.PrepareAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overridable Function PrepareAsync (Optional cancellationToken As CancellationToken = Nothing) As Task

매개 변수

cancellationToken
CancellationToken

비동기 작업을 취소하기 위한 선택적 토큰입니다. 기본값은 None입니다.

반환

비동기 작업을 나타내는 Task입니다.

예외

취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.

설명

이 비동기 메서드의 기본 구현은 해당 동기 메서드에 위임하고 호출 스레드를 차단할 가능성이 있는 완료된 Task를 반환합니다.

비동기 프로그래밍을 지원하는 데이터 공급자는 비동기 I/O 작업을 사용하여 기본 구현을 재정의해야 합니다.

속성이 로 CommandType 설정된 TableDirectPrepareAsync 경우 아무 것도 수행하지 않습니다. 가 로 StoredProcedure설정된 경우 CommandType 에 대한 PrepareAsync 호출은 성공해야 하지만 no-op이 발생할 수 있습니다.

이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 태스크에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw Prepare()된 예외를 참조하세요.

적용 대상