SqlDataReader.ReadAsync(CancellationToken) 메서드

정의

네임스페이스:

System.Data.SqlClient

어셈블리:

System.Data.SqlClient.dll

패키지:

System.Data.SqlClient v4.8.6

Read()를 다음 레코드로 이동하는 비동기 버전의 SqlDataReader입니다.

취소 토큰은 명령 시간 제한이 경과하기 전에 작업을 취소하는 요청에 사용할 수 있습니다. 예외는 반환된 작업 개체를 통해 보고됩니다.

public:
 override System::Threading::Tasks::Task<bool> ^ ReadAsync(System::Threading::CancellationToken cancellationToken);

public override System.Threading.Tasks.Task<bool> ReadAsync (System.Threading.CancellationToken cancellationToken);

override this.ReadAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>

Public Overrides Function ReadAsync (cancellationToken As CancellationToken) As Task(Of Boolean)

매개 변수

cancellationToken

CancellationToken

취소 명령입니다.

반환

Task<Boolean>

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

예외

InvalidOperationException

작업 완료 전에 동일한 인스턴스에 대해 ReadAsync(CancellationToken)를 두 번 이상 호출

Context Connection=true가 연결 문자열에 지정되어 있습니다.

SqlException

SQL Server에서 명령 텍스트를 실행하는 동안 오류를 반환했습니다.

OperationCanceledException

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

설명

의 ExecuteReaderAsync 매개 변수가 behavior 로 DefaultReadAsync 설정된 경우 작업을 반환하기 전에 전체 행을 읽습니다.

코드 샘플을 포함하여 SQL Server .NET Framework 데이터 공급자의 비동기 프로그래밍에 대한 자세한 내용은 비동기 프로그래밍을 참조하세요.

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

추가 정보

• ADO.NET 개요