SqlCommand.ExecuteReaderAsync 메서드

정의

네임스페이스:

Microsoft.Data.SqlClient

어셈블리:

Microsoft.Data.SqlClient.dll

패키지:

Microsoft.Data.SqlClient v7.0.1

오버로드

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하고 빌드 Connection 하는 비동기 버전의 SqlDataReader취소 토큰을 사용하여 명령 제한 시간이 경과하기 전에 작업을 중단하도록 요청할 수 있습니다. 반환된 Task 개체를 통해 예외가 보고됩니다.

ExecuteReaderAsync()

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

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

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

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

Public Function ExecuteReaderAsync () As Task(Of SqlDataReader)

반품

Task<SqlDataReader>

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

예외

InvalidCastException

• 로 SqlDbType 설정되었을 때 Binary 사용되었거나 VarBinary 다른 Value 항목Stream입니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.
• SqlDbType, , Char또는 NCharNVarCharVarChar로 설정Xml되었을 때 Value 사용된 이외의 TextReaderA입니다.
• 로 SqlDbType 설정되었을 때 Xml 사용된 이외의 Value A입니다XmlReader.

ArgumentException

잘못된 값입니다 CommandBehavior .

InvalidOperationException

• 작업이 완료되기 전에 동일한 인스턴스에 대해 두 번 이상 호출 ExecuteReaderAsync() 합니다.
• SqlConnection 스트리밍 작업 중에 닫혔거나 삭제된 경우 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.

SqlException

• SQL Server 명령 텍스트를 실행하는 동안 오류를 반환했습니다.
• 스트리밍 작업 중에 시간 제한이 발생했습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.

IOException

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

ObjectDisposedException

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

설명

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

메모

서버에서 장기 실행 쿼리의 경우 취소 토큰을 통해 쿼리를 취소하는 알려진 문제로 인해 사용하는 ExecuteReader 것이 좋습니다. 또한 메서드를 사용하여 실행을 취소하는 것이 좋습니다 Cancel .

ExecuteReaderAsync(CommandBehavior)

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

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

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

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

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

매개 변수

behavior

CommandBehavior

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

반품

Task<SqlDataReader>

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

예외

InvalidCastException

• 로 SqlDbType 설정되었을 때 Binary 사용되었거나 VarBinary 다른 Value 항목Stream입니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.
• SqlDbType, , Char또는 NCharNVarCharVarChar로 설정Xml되었을 때 Value 사용된 이외의 TextReaderA입니다.
• 로 SqlDbType 설정되었을 때 Xml 사용된 이외의 Value A입니다XmlReader.

ArgumentException

잘못된 값입니다 CommandBehavior .

InvalidOperationException

• 작업이 완료되기 전에 동일한 인스턴스에 대해 두 번 이상 호출 ExecuteReaderAsync(CommandBehavior) 합니다.
• SqlConnection 스트리밍 작업 중에 닫혀 있거나 삭제되었습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.

SqlException

• SQL Server 명령 텍스트를 실행하는 동안 오류를 반환했습니다.
• 스트리밍 작업 중에 시간 제한이 발생했습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.

IOException

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

ObjectDisposedException

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

설명

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

ExecuteReaderAsync(CancellationToken)

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

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

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

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

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

매개 변수

cancellationToken

CancellationToken

취소 명령입니다.

반품

Task<SqlDataReader>

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

예외

InvalidCastException

• 로 SqlDbType 설정되었을 때 Binary 사용되었거나 VarBinary 다른 Value 항목Stream입니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.
• SqlDbType, , Char또는 NCharNVarCharVarChar로 설정Xml되었을 때 Value 사용된 이외의 TextReaderA입니다.
• 로 SqlDbType 설정되었을 때 Xml 사용된 이외의 Value A입니다XmlReader.

ArgumentException

잘못된 값입니다 CommandBehavior .

InvalidOperationException

• 작업이 완료되기 전에 동일한 인스턴스에 대해 두 번 이상 호출 ExecuteReaderAsync(CommandBehavior, CancellationToken) 합니다.
• SqlConnection 스트리밍 작업 중에 닫혔거나 삭제된 경우 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.

SqlException

• SQL Server 명령 텍스트를 실행하는 동안 오류를 반환했습니다.
• 스트리밍 작업 중에 시간 제한이 발생했습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.

IOException

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

ObjectDisposedException

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

설명

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

ExecuteReaderAsync(CommandBehavior, CancellationToken)

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

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

public System.Threading.Tasks.Task<Microsoft.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<Microsoft.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 설정되었을 때 Binary 사용되었거나 VarBinary 다른 Value 항목Stream입니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.
• SqlDbType, , Char또는 NCharNVarCharVarChar로 설정Xml되었을 때 Value 사용된 이외의 TextReaderA입니다.
• 로 SqlDbType 설정되었을 때 Xml 사용된 이외의 Value A입니다XmlReader.

ArgumentException

잘못된 값입니다 CommandBehavior .

InvalidOperationException

• 작업이 완료되기 전에 동일한 인스턴스에 대해 두 번 이상 호출 ExecuteReaderAsync(CommandBehavior, CancellationToken) 합니다.
• SqlConnection 스트리밍 작업 중에 닫혔거나 삭제된 경우 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.

SqlException

• SQL Server 명령 텍스트를 실행하는 동안 오류를 반환했습니다.
• 스트리밍 작업 중에 시간 제한이 발생했습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.

IOException

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

ObjectDisposedException

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

설명

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