SqlCommand.ExecuteReaderAsync 메서드

정의

네임스페이스:

System.Data.SqlClient

어셈블리:

System.Data.dll

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

오버로드

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

설명

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

ExecuteReaderAsync()

를 보내고 ExecuteReader()CommandText 빌드하는 비동기 버전Connection입니다SqlDataReader. 반환된 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

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

-또는-

SqlDbType Char, NChar, NVarChar, VarChar 또는 Xml 이외의 다른 항목은 로 설정Value되었을 때 TextReader 사용되었습니다.

-또는-

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

ArgumentException

잘못된 값입니다 CommandBehavior .

InvalidOperationException

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

-또는-

SqlConnection 스트리밍 작업 중에 닫혔거나 삭제된 경우 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.

-또는-

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

SqlException

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

-또는-

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

IOException

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

ObjectDisposedException

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

설명

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

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

추가 정보

• ADO.NET 개요

ExecuteReaderAsync(CommandBehavior)

로 보내고 ExecuteReader(CommandBehavior)CommandText 빌드하는 비동기 버전Connection입니다SqlDataReader. 반환된 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

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

반품

Task<SqlDataReader>

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

예외

InvalidCastException

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

-또는-

SqlDbType Char, NChar, NVarChar, VarChar 또는 Xml 이외의 다른 항목은 로 설정Value되었을 때 TextReader 사용되었습니다.

-또는-

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

ArgumentException

잘못된 값입니다 CommandBehavior .

InvalidOperationException

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

-또는-

SqlConnection 스트리밍 작업 중에 닫혔거나 삭제된 경우 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.

-또는-

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

SqlException

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

-또는-

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

IOException

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

ObjectDisposedException

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

설명

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

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

추가 정보

• ADO.NET 개요

ExecuteReaderAsync(CancellationToken)

를 보내고 ExecuteReader()CommandText 빌드하는 비동기 버전Connection입니다SqlDataReader.

취소 토큰을 사용하여 명령 시간 제한이 경과하기 전에 작업을 중단하도록 요청할 수 있습니다. 반환된 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

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

-또는-

SqlDbType Char, NChar, NVarChar, VarChar 또는 Xml 이외의 다른 항목은 로 설정Value되었을 때 TextReader 사용되었습니다.

-또는-

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

ArgumentException

잘못된 값입니다 CommandBehavior .

InvalidOperationException

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

-또는-

SqlConnection 스트리밍 작업 중에 닫혔거나 삭제된 경우 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.

-또는-

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

SqlException

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

-또는-

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

IOException

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

ObjectDisposedException

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

OperationCanceledException

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

설명

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

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

추가 정보

• ADO.NET 개요

ExecuteReaderAsync(CommandBehavior, CancellationToken)

를 전송 ExecuteReader(CommandBehavior)CommandText하고 를 빌드하는 비동기 버전 ConnectionSqlDataReader

취소 토큰을 사용하여 명령 시간 제한이 경과하기 전에 작업을 중단하도록 요청할 수 있습니다. 반환된 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

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

cancellationToken

CancellationToken

취소 명령입니다.

반품

Task<SqlDataReader>

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

예외

InvalidCastException

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

-또는-

SqlDbType Char, NChar, NVarChar, VarChar 또는 Xml 이외의 다른 항목은 로 설정Value되었을 때 TextReader 사용되었습니다.

-또는-

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

ArgumentException

잘못된 값입니다 CommandBehavior .

InvalidOperationException

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

-또는-

SqlConnection 스트리밍 작업 중에 닫혔거나 삭제된 경우 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.

-또는-

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

SqlException

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

-또는-

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

IOException

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

ObjectDisposedException

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

OperationCanceledException

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

설명

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

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

추가 정보

• ADO.NET 개요