SqlCommand.ExecuteXmlReaderAsync 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
이에 SqlCommand 설명된 Transact-SQL 문 또는 저장 프로시저의 비동기 실행을 시작하고 결과를 개체로 XmlReader 반환합니다.
오버로드
| Name | Description |
|---|---|
| ExecuteXmlReaderAsync() |
개체를 보내고 ExecuteXmlReader()CommandText 빌드하는 비동기 버전Connection입니다XmlReader. 반환된 Task 개체를 통해 예외가 보고됩니다. |
| ExecuteXmlReaderAsync(CancellationToken) |
개체를 보내고 ExecuteXmlReader()CommandText 빌드하는 비동기 버전Connection입니다XmlReader. 취소 토큰을 사용하여 명령 시간 제한이 경과하기 전에 작업을 중단하도록 요청할 수 있습니다. 반환된 Task 개체를 통해 예외가 보고됩니다. |
ExecuteXmlReaderAsync()
개체를 보내고 ExecuteXmlReader()CommandText 빌드하는 비동기 버전Connection입니다XmlReader.
반환된 Task 개체를 통해 예외가 보고됩니다.
public:
System::Threading::Tasks::Task<System::Xml::XmlReader ^> ^ ExecuteXmlReaderAsync();public System.Threading.Tasks.Task<System.Xml.XmlReader> ExecuteXmlReaderAsync();member this.ExecuteXmlReaderAsync : unit -> System.Threading.Tasks.Task<System.Xml.XmlReader>Public Function ExecuteXmlReaderAsync () As Task(Of XmlReader)반품
비동기 작업을 나타내는 작업입니다.
예외
SqlDbType 이진 또는 VarBinary 이외의 다른 항목은 로 설정Value되었을 때 Stream 사용되었습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.
-또는-
SqlDbType Char, NChar, NVarChar, VarChar 또는 Xml 이외의 다른 항목은 로 설정Value되었을 때 TextReader 사용되었습니다.
-또는-
작업이 완료되기 전에 동일한 인스턴스에 대해 두 번 이상 호출 ExecuteScalarAsync(CancellationToken) 합니다.
-또는-
SqlConnection 스트리밍 작업 중에 닫혔거나 삭제된 경우 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.
-또는-
Context Connection=true 연결 문자열 지정됩니다.
SQL Server 명령 텍스트를 실행하는 동안 오류를 반환했습니다.
-또는-
스트리밍 작업 중에 시간 제한이 발생했습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.
스트리밍 작업 중 또는 StreamXmlReader 개체에서 TextReader오류가 발생했습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.
Stream또는 XmlReaderTextReader 개체가 스트리밍 작업 중에 닫혔습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.
설명
이 메서드에서 반환된 XmlReader 는 비동기 작업을 지원하지 않습니다.
SQL Server 대한 .NET Framework Data Provider 비동기 프로그래밍에 대한 자세한 내용은 동기 프로그래밍을 참조하세요.
이 메서드는 메서드의 동기 대응이 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 태스크가 대기될 때 해당 예외가 throw됩니다. ArgumentException같은 사용 예외는 여전히 동기적으로 던져집니다. 저장된 예외는 .에 의해 ExecuteXmlReader()throw된 예외를 참조하세요.
추가 정보
적용 대상
ExecuteXmlReaderAsync(CancellationToken)
개체를 보내고 ExecuteXmlReader()CommandText 빌드하는 비동기 버전Connection입니다XmlReader.
취소 토큰을 사용하여 명령 시간 제한이 경과하기 전에 작업을 중단하도록 요청할 수 있습니다. 반환된 Task 개체를 통해 예외가 보고됩니다.
public:
System::Threading::Tasks::Task<System::Xml::XmlReader ^> ^ ExecuteXmlReaderAsync(System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Xml.XmlReader> ExecuteXmlReaderAsync(System.Threading.CancellationToken cancellationToken);member this.ExecuteXmlReaderAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Xml.XmlReader>Public Function ExecuteXmlReaderAsync (cancellationToken As CancellationToken) As Task(Of XmlReader)매개 변수
- cancellationToken
- CancellationToken
취소 명령입니다.
반품
비동기 작업을 나타내는 작업입니다.
예외
SqlDbType 이진 또는 VarBinary 이외의 다른 항목은 로 설정Value되었을 때 Stream 사용되었습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.
-또는-
SqlDbType Char, NChar, NVarChar, VarChar 또는 Xml 이외의 다른 항목은 로 설정Value되었을 때 TextReader 사용되었습니다.
-또는-
작업이 완료되기 전에 동일한 인스턴스에 대해 두 번 이상 호출 ExecuteScalarAsync(CancellationToken) 합니다.
-또는-
SqlConnection 스트리밍 작업 중에 닫혔거나 삭제된 경우 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.
-또는-
Context Connection=true 연결 문자열 지정됩니다.
SQL Server 명령 텍스트를 실행하는 동안 오류를 반환했습니다.
-또는-
스트리밍 작업 중에 시간 제한이 발생했습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.
스트리밍 작업 중 또는 StreamXmlReader 개체에서 TextReader오류가 발생했습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.
Stream또는 XmlReaderTextReader 개체가 스트리밍 작업 중에 닫혔습니다. 스트리밍에 대한 자세한 내용은 SqlClient 스트리밍 지원을 참조하세요.
취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.
설명
이 메서드에서 반환된 XmlReader 는 비동기 작업을 지원하지 않습니다.
SQL Server 대한 .NET Framework Data Provider 비동기 프로그래밍에 대한 자세한 내용은 동기 프로그래밍을 참조하세요.
이 메서드는 메서드의 동기 대응이 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 태스크가 대기될 때 해당 예외가 throw됩니다. ArgumentException같은 사용 예외는 여전히 동기적으로 던져집니다. 저장된 예외는 .에 의해 ExecuteXmlReader()throw된 예외를 참조하세요.