SqlCommand.ExecuteReaderAsync 메서드

  • 참조

정의

네임스페이스:
System.Data.SqlClient
어셈블리:
System.Data.SqlClient.dll
어셈블리:
System.Data.dll
패키지:
System.Data.SqlClient v4.8.6

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

오버로드

ExecuteReaderAsync()

CommandText를 Connection에 보내고 SqlDataReader를 작성하는 ExecuteReader()의 비동기 버전입니다. 예외는 반환된 작업 개체를 통해 보고됩니다.
ExecuteReaderAsync(CommandBehavior)

CommandText를 Connection에 보내고 SqlDataReader를 작성하는 ExecuteReader(CommandBehavior)의 비동기 버전입니다. 예외는 반환된 작업 개체를 통해 보고됩니다.
ExecuteReaderAsync(CancellationToken)

CommandText를 Connection에 보내고 SqlDataReader를 작성하는 ExecuteReader()의 비동기 버전입니다.

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

CommandText를 Connection에 보내고 SqlDataReader를 작성하는 ExecuteReader(CommandBehavior)의 비동기 버전입니다.

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

설명

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

ExecuteReaderAsync()

CommandText를 Connection에 보내고 SqlDataReader를 작성하는 ExecuteReader()의 비동기 버전입니다. 예외는 반환된 작업 개체를 통해 보고됩니다.

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>

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

예외

InvalidCastException

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

또는

이 SqlDbType 로 설정된 TextReader경우 ValueChar, NChar, NVarChar, VarChar 또는 Xml 이외의 가 사용되었습니다.

또는

이 로 SqlDbType 설정XmlReader되었을 때 ValueXml 이외의 가 사용되었습니다.

ArgumentException

CommandBehavior 값이 잘못되었습니다.

InvalidOperationException

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

또는

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

또는

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

SqlException

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

또는

스트리밍 작업 동안 시간이 초과되었습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.

IOException

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

ObjectDisposedException

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

설명

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

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

추가 정보

적용 대상

ExecuteReaderAsync(CommandBehavior)

CommandText를 Connection에 보내고 SqlDataReader를 작성하는 ExecuteReader(CommandBehavior)의 비동기 버전입니다. 예외는 반환된 작업 개체를 통해 보고됩니다.

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>

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

예외

InvalidCastException

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

또는

이 SqlDbType 로 설정된 TextReader경우 ValueChar, NChar, NVarChar, VarChar 또는 Xml 이외의 가 사용되었습니다.

또는

이 로 SqlDbType 설정XmlReader되었을 때 ValueXml 이외의 가 사용되었습니다.

ArgumentException

CommandBehavior 값이 잘못되었습니다.

InvalidOperationException

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

또는

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

또는

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

SqlException

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

또는

스트리밍 작업 동안 시간이 초과되었습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.

IOException

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

ObjectDisposedException

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

설명

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

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

추가 정보

적용 대상

ExecuteReaderAsync(CancellationToken)

CommandText를 Connection에 보내고 SqlDataReader를 작성하는 ExecuteReader()의 비동기 버전입니다.

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

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>

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

예외

InvalidCastException

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

또는

이 SqlDbType 로 설정된 TextReader경우 ValueChar, NChar, NVarChar, VarChar 또는 Xml 이외의 가 사용되었습니다.

또는

이 로 SqlDbType 설정XmlReader되었을 때 ValueXml 이외의 가 사용되었습니다.

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

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

설명

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

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

추가 정보

적용 대상

ExecuteReaderAsync(CommandBehavior, CancellationToken)

CommandText를 Connection에 보내고 SqlDataReader를 작성하는 ExecuteReader(CommandBehavior)의 비동기 버전입니다.

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

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>

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

예외

InvalidCastException

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

또는

이 SqlDbType 로 설정된 TextReader경우 ValueChar, NChar, NVarChar, VarChar 또는 Xml 이외의 가 사용되었습니다.

또는

이 로 SqlDbType 설정XmlReader되었을 때 ValueXml 이외의 가 사용되었습니다.

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

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

설명

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

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

추가 정보

적용 대상