DbDataReader.ReadAsync 메서드

정의

네임스페이스:

System.Data.Common

어셈블리:

System.Data.Common.dll

판독기를 결과 집합의 다음 레코드로 비동기로 이동합니다.

오버로드

ReadAsync()	판독기를 결과 집합의 다음 레코드로 비동기로 이동합니다.
ReadAsync(CancellationToken)	판독기를 결과 집합의 다음 레코드로 비동기로 이동합니다.

설명

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

ReadAsync()

Source:

DbDataReader.cs

판독기를 결과 집합의 다음 레코드로 비동기로 이동합니다.

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

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

member this.ReadAsync : unit -> System.Threading.Tasks.Task<bool>

Public Function ReadAsync () As Task(Of Boolean)

반환

Task<Boolean>

더 많은 행이 있으면 Task<TResult>의 Result 속성이 true, 아니면 false입니다.

예외

DbException

명령 텍스트를 실행하는 동안 오류가 발생했습니다.

설명

이 비동기 메서드의 기본 구현은 동기 대응 메서드를 호출하고 완료된 Task를 반환하여 호출 스레드를 차단할 수 있습니다.

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

반환된 작업이 아직 완료되지 않은 상태에서는 DbDataReader 개체의 다른 메서드와 속성을 호출하면 안 됩니다.

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

추가 정보

• ADO.NET 개요

ReadAsync(CancellationToken)

Source:

DbDataReader.cs

판독기를 결과 집합의 다음 레코드로 비동기로 이동합니다.

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

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

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

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

매개 변수

cancellationToken

CancellationToken

취소 명령입니다.

반환

Task<Boolean>

더 많은 행이 있으면 Task<TResult>의 Result 속성이 true, 아니면 false입니다.

예외

DbException

명령 텍스트를 실행하는 동안 오류가 발생했습니다.

OperationCanceledException

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

설명

이 비동기 메서드의 기본 구현은 동기 대응 메서드를 호출하고 완료된 Task를 반환하여 호출 스레드를 차단할 수 있습니다. 이미 취소된 취소 토큰을 전달한 경우 기본 구현은 취소된 작업도 반환합니다.

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

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

반환된 작업이 아직 완료되지 않은 상태에서는 DbDataReader 개체의 다른 메서드와 속성을 호출하면 안 됩니다.

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

추가 정보

• ADO.NET 개요