DbCommand.ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) 메서드

  • 참조

정의

네임스페이스:
System.Data.Common
어셈블리:
System.Data.Common.dll
어셈블리:
System.Data.dll
어셈블리:
netstandard.dll
Source:
DbCommand.cs
Source:
DbCommand.cs
Source:
DbCommand.cs

공급자는 ExecuteReader 오버로드에 기본값이 아닌 구현을 제공하도록 이 메서드를 구현해야 합니다.

기본 구현은 동기 ExecuteReader() 메서드를 호출하고, 호출 스레드를 차단하면서 완료된 작업을 반환합니다. 기본 구현은 이미 취소된 취소 토큰을 전달하는 경우 취소된 작업을 반환합니다. ExecuteReader에서 throw되는 예외는 반환된 Task Exception 속성을 통해 전달됩니다.

이 메서드는 조기에 취소할 작업을 요청하는 데 사용할 수 있는 취소 토큰을 허용합니다. 구현은 이 요청을 무시할 수 있습니다.

protected:
 virtual System::Threading::Tasks::Task<System::Data::Common::DbDataReader ^> ^ ExecuteDbDataReaderAsync(System::Data::CommandBehavior behavior, System::Threading::CancellationToken cancellationToken);
protected virtual System.Threading.Tasks.Task<System.Data.Common.DbDataReader> ExecuteDbDataReaderAsync (System.Data.CommandBehavior behavior, System.Threading.CancellationToken cancellationToken);
abstract member ExecuteDbDataReaderAsync : System.Data.CommandBehavior * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.Common.DbDataReader>
override this.ExecuteDbDataReaderAsync : System.Data.CommandBehavior * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.Common.DbDataReader>
Protected Overridable Function ExecuteDbDataReaderAsync (behavior As CommandBehavior, cancellationToken As CancellationToken) As Task(Of DbDataReader)

매개 변수

behavior
CommandBehavior

명령 실행 및 데이터 검색 옵션을 지정하는 의 CommandBehaviorinstance.

cancellationToken
CancellationToken

비동기 작업을 취소하기 위한 토큰입니다.

반환

Task<DbDataReader>

비동기 작업(operation)을 나타내는 작업(task)입니다.

예외

DbException

명령을 실행하는 동안 오류가 발생했습니다.

ArgumentException

CommandBehavior 값이 잘못되었습니다.

OperationCanceledException

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

설명

비동기 프로그래밍에 대한 자세한 내용은 비동기 프로그래밍을 참조하세요.

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

적용 대상

추가 정보