SqlCommand.ExecuteReaderAsync 메서드

정의

네임스페이스:

System.Data.SqlClient

어셈블리:

System.Data.dll

이 SqlCommand설명된 Transact-SQL 문 또는 저장 프로시저의 비동기 실행을 시작합니다.

오버로드

ExecuteReaderAsync()	CommandText Connection 보내고 SqlDataReader빌드하는 비동기 버전의 ExecuteReader(). 반환된 Task 개체를 통해 예외가 보고됩니다.
ExecuteReaderAsync(CommandBehavior)	CommandText Connection보내고 SqlDataReader빌드하는 비동기 버전의 ExecuteReader(CommandBehavior). 반환된 Task 개체를 통해 예외가 보고됩니다.
ExecuteReaderAsync(CancellationToken)	CommandText Connection 보내고 SqlDataReader빌드하는 비동기 버전의 ExecuteReader(). 취소 토큰을 사용하여 명령 시간 제한이 경과하기 전에 작업을 중단하도록 요청할 수 있습니다. 반환된 Task 개체를 통해 예외가 보고됩니다.
ExecuteReaderAsync(CommandBehavior, CancellationToken)	CommandText Connection보내고 SqlDataReader 빌드하는 비동기 버전의 ExecuteReader(CommandBehavior) 취소 토큰을 사용하여 명령 시간 제한이 경과하기 전에 작업을 중단하도록 요청할 수 있습니다. 반환된 Task 개체를 통해 예외가 보고됩니다.

설명

.NET Framework Data Provider for SQL Server의 비동기 프로그래밍에 대한 자세한 내용은 비동기 프로그래밍참조하세요.

ExecuteReaderAsync()

CommandText Connection 보내고 SqlDataReader빌드하는 비동기 버전의 ExecuteReader(). 반환된 Task 개체를 통해 예외가 보고됩니다.

public:
 System::Threading::Tasks::Task<System::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync();

public System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader> ExecuteReaderAsync ();

override this.ExecuteReaderAsync : unit -> System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader>

Public Function ExecuteReaderAsync () As Task(Of SqlDataReader)

반환

Task<SqlDataReader>

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

예외

InvalidCastException

Value Stream설정되었을 때 이진 또는 VarBinary 이외의 SqlDbType 사용되었습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원참조하세요.

-또는-

Value TextReader설정할 때 Char, NChar, NVarChar, VarChar또는 Xml 이외의 SqlDbType 사용되었습니다.

-또는-

Value XmlReader설정되었을 때 Xml 이외의 SqlDbType 사용되었습니다.

ArgumentException

잘못된 CommandBehavior 값입니다.

InvalidOperationException

작업이 완료되기 전에 동일한 인스턴스에 대해 ExecuteReaderAsync() 두 번 이상 호출합니다.

-또는-

스트리밍 작업 중에 SqlConnection 닫혀 있거나 삭제되었습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원참조하세요.

-또는-

Context Connection=true 연결 문자열에 지정됩니다.

SqlException

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

-또는-

스트리밍 작업 중에 시간 제한이 발생했습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원참조하세요.

IOException

스트리밍 작업 중 Stream, XmlReader 또는 TextReader 개체에서 오류가 발생했습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원참조하세요.

ObjectDisposedException

스트리밍 작업 중에 Stream, XmlReader 또는 TextReader 개체가 닫혔습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원참조하세요.

설명

.NET Framework Data Provider for SQL Server의 비동기 프로그래밍에 대한 자세한 내용은 비동기 프로그래밍참조하세요.

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

추가 정보

• ADO.NET 개요

ExecuteReaderAsync(CommandBehavior)

CommandText Connection보내고 SqlDataReader빌드하는 비동기 버전의 ExecuteReader(CommandBehavior). 반환된 Task 개체를 통해 예외가 보고됩니다.

public:
 System::Threading::Tasks::Task<System::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync(System::Data::CommandBehavior behavior);

public System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader> ExecuteReaderAsync (System.Data.CommandBehavior behavior);

override this.ExecuteReaderAsync : System.Data.CommandBehavior -> System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader>

Public Function ExecuteReaderAsync (behavior As CommandBehavior) As Task(Of SqlDataReader)

매개 변수

behavior

CommandBehavior

문 실행 및 데이터 검색에 대한 옵션입니다. Default설정되면 ReadAsync(CancellationToken) 전체 작업을 반환하기 전에 전체 행을 읽습니다.

반환

Task<SqlDataReader>

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

예외

InvalidCastException

Value Stream설정되었을 때 이진 또는 VarBinary 이외의 SqlDbType 사용되었습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원참조하세요.

-또는-

Value TextReader설정할 때 Char, NChar, NVarChar, VarChar또는 Xml 이외의 SqlDbType 사용되었습니다.

-또는-

Value XmlReader설정되었을 때 Xml 이외의 SqlDbType 사용되었습니다.

ArgumentException

잘못된 CommandBehavior 값입니다.

InvalidOperationException

작업이 완료되기 전에 동일한 인스턴스에 대해 ExecuteReaderAsync(CommandBehavior) 두 번 이상 호출합니다.

-또는-

스트리밍 작업 중에 SqlConnection 닫혀 있거나 삭제되었습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원참조하세요.

-또는-

Context Connection=true 연결 문자열에 지정됩니다.

SqlException

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

-또는-

스트리밍 작업 중에 시간 제한이 발생했습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원참조하세요.

IOException

스트리밍 작업 중 Stream, XmlReader 또는 TextReader 개체에서 오류가 발생했습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원참조하세요.

ObjectDisposedException

스트리밍 작업 중에 Stream, XmlReader 또는 TextReader 개체가 닫혔습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원참조하세요.

설명

.NET Framework Data Provider for SQL Server의 비동기 프로그래밍에 대한 자세한 내용은 비동기 프로그래밍참조하세요.

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

추가 정보

• ADO.NET 개요

ExecuteReaderAsync(CancellationToken)

CommandText Connection 보내고 SqlDataReader빌드하는 비동기 버전의 ExecuteReader().

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

public:
 System::Threading::Tasks::Task<System::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync(System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader> ExecuteReaderAsync (System.Threading.CancellationToken cancellationToken);

override this.ExecuteReaderAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader>

Public Function ExecuteReaderAsync (cancellationToken As CancellationToken) As Task(Of SqlDataReader)

매개 변수

cancellationToken

CancellationToken

취소 명령입니다.

반환

Task<SqlDataReader>

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

예외

InvalidCastException

Value Stream설정되었을 때 이진 또는 VarBinary 이외의 SqlDbType 사용되었습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원참조하세요.

-또는-

Value TextReader설정할 때 Char, NChar, NVarChar, VarChar또는 Xml 이외의 SqlDbType 사용되었습니다.

-또는-

Value XmlReader설정되었을 때 Xml 이외의 SqlDbType 사용되었습니다.

ArgumentException

잘못된 CommandBehavior 값입니다.

InvalidOperationException

작업이 완료되기 전에 동일한 인스턴스에 대해 ExecuteReaderAsync(CommandBehavior, CancellationToken) 두 번 이상 호출합니다.

-또는-

스트리밍 작업 중에 SqlConnection 닫혀 있거나 삭제되었습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원참조하세요.

-또는-

Context Connection=true 연결 문자열에 지정됩니다.

SqlException

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

-또는-

스트리밍 작업 중에 시간 제한이 발생했습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원참조하세요.

IOException

스트리밍 작업 중 Stream, XmlReader 또는 TextReader 개체에서 오류가 발생했습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원참조하세요.

ObjectDisposedException

스트리밍 작업 중에 Stream, XmlReader 또는 TextReader 개체가 닫혔습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원참조하세요.

OperationCanceledException

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

설명

.NET Framework Data Provider for SQL Server의 비동기 프로그래밍에 대한 자세한 내용은 비동기 프로그래밍참조하세요.

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

추가 정보

• ADO.NET 개요

ExecuteReaderAsync(CommandBehavior, CancellationToken)

CommandText Connection보내고 SqlDataReader 빌드하는 비동기 버전의 ExecuteReader(CommandBehavior)

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

public:
 System::Threading::Tasks::Task<System::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync(System::Data::CommandBehavior behavior, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader> ExecuteReaderAsync (System.Data.CommandBehavior behavior, System.Threading.CancellationToken cancellationToken);

override this.ExecuteReaderAsync : System.Data.CommandBehavior * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader>

Public Function ExecuteReaderAsync (behavior As CommandBehavior, cancellationToken As CancellationToken) As Task(Of SqlDataReader)

매개 변수

behavior

CommandBehavior

문 실행 및 데이터 검색에 대한 옵션입니다. Default설정되면 ReadAsync(CancellationToken) 전체 작업을 반환하기 전에 전체 행을 읽습니다.

cancellationToken

CancellationToken

취소 명령입니다.

반환

Task<SqlDataReader>

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

예외

InvalidCastException

Value Stream설정되었을 때 이진 또는 VarBinary 이외의 SqlDbType 사용되었습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원참조하세요.

-또는-

Value TextReader설정할 때 Char, NChar, NVarChar, VarChar또는 Xml 이외의 SqlDbType 사용되었습니다.

-또는-

Value XmlReader설정되었을 때 Xml 이외의 SqlDbType 사용되었습니다.

ArgumentException

잘못된 CommandBehavior 값입니다.

InvalidOperationException

작업이 완료되기 전에 동일한 인스턴스에 대해 ExecuteReaderAsync(CommandBehavior, CancellationToken) 두 번 이상 호출합니다.

-또는-

스트리밍 작업 중에 SqlConnection 닫혀 있거나 삭제되었습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원참조하세요.

-또는-

Context Connection=true 연결 문자열에 지정됩니다.

SqlException

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

-또는-

스트리밍 작업 중에 시간 제한이 발생했습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원참조하세요.

IOException

스트리밍 작업 중 Stream, XmlReader 또는 TextReader 개체에서 오류가 발생했습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원참조하세요.

ObjectDisposedException

스트리밍 작업 중에 Stream, XmlReader 또는 TextReader 개체가 닫혔습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원참조하세요.

OperationCanceledException

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

설명

.NET Framework Data Provider for SQL Server의 비동기 프로그래밍에 대한 자세한 내용은 비동기 프로그래밍참조하세요.

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

추가 정보

• ADO.NET 개요