SqlCommand.ExecuteReaderAsync 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
오버로드
| ExecuteReaderAsync() |
를 로 보내고 ConnectionCommandText 를 빌드하는 의 비동기 버전 ExecuteReader() 입니다 SqlDataReader . 예외는 반환된 작업 개체를 통해 보고됩니다. |
| ExecuteReaderAsync(CommandBehavior) |
를 로 보내고 ConnectionCommandText 를 빌드하는 의 비동기 버전 ExecuteReader(CommandBehavior) 입니다 SqlDataReader . 예외는 반환된 작업 개체를 통해 보고됩니다. |
| ExecuteReaderAsync(CancellationToken) |
를 로 보내고 ConnectionCommandText 를 빌드하는 의 비동기 버전 ExecuteReader() 입니다 SqlDataReader . 취소 토큰은 명령 시간 제한이 경과하기 전에 작업을 취소하는 요청에 사용할 수 있습니다. 예외는 반환된 작업 개체를 통해 보고됩니다. |
| ExecuteReaderAsync(CommandBehavior, CancellationToken) |
를 에 보내고 CommandTextConnection 를 빌드 SqlDataReader 하는 의 비동기 버전 ExecuteReader(CommandBehavior) 취소 토큰을 사용하여 명령 시간 제한이 경과하기 전에 작업을 중단하도록 요청할 수 있습니다. 예외는 반환된 작업 개체를 통해 보고됩니다. |
ExecuteReaderAsync()
를 로 보내고 ConnectionCommandText 를 빌드하는 의 비동기 버전 ExecuteReader() 입니다 SqlDataReader . 예외는 반환된 작업 개체를 통해 보고됩니다.
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)반환
비동기 작업(operation)을 나타내는 작업(task)입니다.
예외
이 SqlDbType 로 설정된 Stream 경우 ValueBinary 또는 VarBinary 이외의 가 사용되었습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.
또는
이 로 SqlDbType 설정 TextReader 되었을 때 ValueChar, NChar, NVarChar, VarChar 또는 Xml 이외의 가 사용되었습니다.
또는
CommandBehavior 값이 잘못되었습니다.
작업 완료 전에 동일한 인스턴스에 대해 ExecuteReaderAsync()를 두 번 이상 호출
또는
스트리밍 작업 동안 SqlConnection이 닫히거나 삭제되었습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.
SQL Server에서 명령 텍스트를 실행하는 동안 오류를 반환했습니다.
또는
스트리밍 작업 동안 시간이 초과되었습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.
스트리밍 작업 중에 또는 XmlReaderTextReader 개체에서 Stream 오류가 발생했습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.
Stream 또는 XmlReaderTextReader 개체가 스트리밍 작업 중에 닫혔습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.
설명
SQL Server .NET Framework 데이터 공급자의 비동기 프로그래밍에 대한 자세한 내용은 비동기 프로그래밍을 참조하세요.
참고
서버에서 장기 실행 쿼리의 경우 취소 토큰을 통해 쿼리를 취소하는 알려진 문제로 인해 를 사용하는 ExecuteReader 것이 좋습니다. 또한 메서드를 사용하여 실행을 취소하는 것이 Cancel 좋습니다.
적용 대상
ExecuteReaderAsync(CommandBehavior)
를 로 보내고 ConnectionCommandText 를 빌드하는 의 비동기 버전 ExecuteReader(CommandBehavior) 입니다 SqlDataReader . 예외는 반환된 작업 개체를 통해 보고됩니다.
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
문 실행 및 데이터 검색을 위한 옵션입니다. 가 로 설정된 경우Default 는 ReadAsync(CancellationToken) 전체 작업을 반환하기 전에 전체 행을 읽습니다.
반환
비동기 작업(operation)을 나타내는 작업(task)입니다.
예외
이 SqlDbType 로 설정된 Stream 경우 ValueBinary 또는 VarBinary 이외의 가 사용되었습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.
또는
이 로 SqlDbType 설정 TextReader 되었을 때 ValueChar, NChar, NVarChar, VarChar 또는 Xml 이외의 가 사용되었습니다.
또는
CommandBehavior 값이 잘못되었습니다.
작업 완료 전에 동일한 인스턴스에 대해 ExecuteReaderAsync(CommandBehavior)를 두 번 이상 호출
-또는- SqlConnection 스트리밍 작업 중에 닫혀 있거나 삭제되었습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.
SQL Server에서 명령 텍스트를 실행하는 동안 오류를 반환했습니다.
또는
스트리밍 작업 동안 시간이 초과되었습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.
스트리밍 작업 중에 또는 XmlReaderTextReader 개체에서 Stream 오류가 발생했습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.
Stream 또는 XmlReaderTextReader 개체가 스트리밍 작업 중에 닫혔습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.
설명
SQL Server .NET Framework 데이터 공급자의 비동기 프로그래밍에 대한 자세한 내용은 비동기 프로그래밍을 참조하세요.
적용 대상
ExecuteReaderAsync(CancellationToken)
를 로 보내고 ConnectionCommandText 를 빌드하는 의 비동기 버전 ExecuteReader() 입니다 SqlDataReader .
취소 토큰은 명령 시간 제한이 경과하기 전에 작업을 취소하는 요청에 사용할 수 있습니다. 예외는 반환된 작업 개체를 통해 보고됩니다.
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
취소 명령입니다.
반환
비동기 작업(operation)을 나타내는 작업(task)입니다.
예외
이 SqlDbType 로 설정된 Stream 경우 ValueBinary 또는 VarBinary 이외의 가 사용되었습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.
또는
이 로 SqlDbType 설정 TextReader 되었을 때 ValueChar, NChar, NVarChar, VarChar 또는 Xml 이외의 가 사용되었습니다.
또는
CommandBehavior 값이 잘못되었습니다.
작업 완료 전에 동일한 인스턴스에 대해 ExecuteReaderAsync(CommandBehavior, CancellationToken)를 두 번 이상 호출
또는
스트리밍 작업 동안 SqlConnection이 닫히거나 삭제되었습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.
SQL Server에서 명령 텍스트를 실행하는 동안 오류를 반환했습니다.
또는
스트리밍 작업 동안 시간이 초과되었습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.
스트리밍 작업 중에 또는 XmlReaderTextReader 개체에서 Stream 오류가 발생했습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.
Stream 또는 XmlReaderTextReader 개체가 스트리밍 작업 중에 닫혔습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.
설명
SQL Server .NET Framework 데이터 공급자의 비동기 프로그래밍에 대한 자세한 내용은 비동기 프로그래밍을 참조하세요.
적용 대상
ExecuteReaderAsync(CommandBehavior, CancellationToken)
를 에 보내고 CommandTextConnection 를 빌드 SqlDataReader 하는 의 비동기 버전 ExecuteReader(CommandBehavior) 취소 토큰을 사용하여 명령 시간 제한이 경과하기 전에 작업을 중단하도록 요청할 수 있습니다. 예외는 반환된 작업 개체를 통해 보고됩니다.
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
문 실행 및 데이터 검색을 위한 옵션입니다. 가 로 설정된 경우Default 는 ReadAsync(CancellationToken) 전체 작업을 반환하기 전에 전체 행을 읽습니다.
- cancellationToken
- CancellationToken
취소 명령입니다.
반환
비동기 작업(operation)을 나타내는 작업(task)입니다.
예외
이 SqlDbType 로 설정된 Stream 경우 ValueBinary 또는 VarBinary 이외의 가 사용되었습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.
또는
이 로 SqlDbType 설정 TextReader 되었을 때 ValueChar, NChar, NVarChar, VarChar 또는 Xml 이외의 가 사용되었습니다.
또는
CommandBehavior 값이 잘못되었습니다.
작업 완료 전에 동일한 인스턴스에 대해 ExecuteReaderAsync(CommandBehavior, CancellationToken)를 두 번 이상 호출
또는
스트리밍 작업 동안 SqlConnection이 닫히거나 삭제되었습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.
SQL Server에서 명령 텍스트를 실행하는 동안 오류를 반환했습니다.
또는
스트리밍 작업 동안 시간이 초과되었습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.
스트리밍 작업 중에 또는 XmlReaderTextReader 개체에서 Stream 오류가 발생했습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.
Stream 또는 XmlReaderTextReader 개체가 스트리밍 작업 중에 닫혔습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.
설명
SQL Server .NET Framework 데이터 공급자의 비동기 프로그래밍에 대한 자세한 내용은 비동기 프로그래밍을 참조하세요.