SqlCommand.ExecuteXmlReaderAsync Метод

Определение

Пространство имен:

System.Data.SqlClient

Сборка:

System.Data.dll

Инициирует асинхронное выполнение инструкции Transact-SQL или хранимой процедуры, описываемой SqlCommand этим XmlReader и возвращающей результаты в виде объекта.

Перегрузки

Имя	Описание
ExecuteXmlReaderAsync()	Асинхронная версия ExecuteXmlReader(), которая отправляет объект и создает CommandTextConnectionXmlReader объект. Исключения будут сообщаться с помощью возвращаемого объекта Task.
ExecuteXmlReaderAsync(CancellationToken)	Асинхронная версия ExecuteXmlReader(), которая отправляет объект и создает CommandTextConnectionXmlReader объект. Маркер отмены можно использовать для запроса на то, что операция будет прекращена до истечения времени ожидания команды. Исключения будут сообщаться с помощью возвращаемого объекта Task.

ExecuteXmlReaderAsync()

Асинхронная версия ExecuteXmlReader(), которая отправляет объект и создает CommandTextConnectionXmlReader объект.

Исключения будут сообщаться с помощью возвращаемого объекта 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)

Возвращаемое значение

Task<XmlReader>

Задача, представляющая асинхронную операцию.

Исключения

InvalidCastException

Если задано значение SqlDbType"Двоичный" или "VarBinary", используется Value значение "ДвоичныйStream" или "VarBinary". Дополнительные сведения о потоковой передаче см. в разделе "Поддержка потоковой передачи SqlClient".

–или–

Если SqlDbType задано значение "Char", "NChar", "NVarChar", Value" или TextReader"

–или–

Значение SqlDbType , отличное от xml , использовалось при Value установке XmlReader.

InvalidOperationException

Вызов ExecuteScalarAsync(CancellationToken) нескольких раз для одного экземпляра перед завершением задачи.

–или–

Закрытый SqlConnection или удаленный во время операции потоковой передачи. Дополнительные сведения о потоковой передаче см. в разделе "Поддержка потоковой передачи SqlClient".

–или–

Context Connection=true указывается в строка подключения.

SqlException

SQL Server возвращает ошибку при выполнении текста команды.

–или–

Время ожидания произошло во время операции потоковой передачи. Дополнительные сведения о потоковой передаче см. в разделе "Поддержка потоковой передачи SqlClient".

IOException

Ошибка произошла в объекте StreamXmlReader или TextReader объекте во время операции потоковой передачи. Дополнительные сведения о потоковой передаче см. в разделе "Поддержка потоковой передачи SqlClient".

ObjectDisposedException

Stream Объект XmlReaderили TextReader объект был закрыт во время операции потоковой передачи. Дополнительные сведения о потоковой передаче см. в разделе "Поддержка потоковой передачи SqlClient".

Комментарии

XmlReader, возвращаемый этим методом, не поддерживает асинхронные операции.

Дополнительные сведения об асинхронном программировании в Data Provider Data Provider SQL Server см. .NET в разделе Asynchronous Programming.

Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых ExecuteXmlReader().

См. также раздел

• Общие сведения об ADO.NET

ExecuteXmlReaderAsync(CancellationToken)

Асинхронная версия ExecuteXmlReader(), которая отправляет объект и создает CommandTextConnectionXmlReader объект.

Маркер отмены можно использовать для запроса на то, что операция будет прекращена до истечения времени ожидания команды. Исключения будут сообщаться с помощью возвращаемого объекта 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

Инструкция отмены.

Возвращаемое значение

Task<XmlReader>

Задача, представляющая асинхронную операцию.

Исключения

InvalidCastException

Если задано значение SqlDbType"Двоичный" или "VarBinary", используется Value значение "ДвоичныйStream" или "VarBinary". Дополнительные сведения о потоковой передаче см. в разделе "Поддержка потоковой передачи SqlClient".

–или–

Если SqlDbType задано значение "Char", "NChar", "NVarChar", Value" или TextReader"

–или–

Значение SqlDbType , отличное от xml , использовалось при Value установке XmlReader.

InvalidOperationException

Вызов ExecuteScalarAsync(CancellationToken) нескольких раз для одного экземпляра перед завершением задачи.

–или–

Закрытый SqlConnection или удаленный во время операции потоковой передачи. Дополнительные сведения о потоковой передаче см. в разделе "Поддержка потоковой передачи SqlClient".

–или–

Context Connection=true указывается в строка подключения.

SqlException

SQL Server возвращает ошибку при выполнении текста команды.

–или–

Время ожидания произошло во время операции потоковой передачи. Дополнительные сведения о потоковой передаче см. в разделе "Поддержка потоковой передачи SqlClient".

IOException

Ошибка произошла в объекте StreamXmlReader или TextReader объекте во время операции потоковой передачи. Дополнительные сведения о потоковой передаче см. в разделе "Поддержка потоковой передачи SqlClient".

ObjectDisposedException

Stream Объект XmlReaderили TextReader объект был закрыт во время операции потоковой передачи. Дополнительные сведения о потоковой передаче см. в разделе "Поддержка потоковой передачи SqlClient".

OperationCanceledException

Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.

Комментарии

XmlReader, возвращаемый этим методом, не поддерживает асинхронные операции.

Дополнительные сведения об асинхронном программировании в Data Provider Data Provider SQL Server см. .NET в разделе Asynchronous Programming.

Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых ExecuteXmlReader().

См. также раздел

• Общие сведения об ADO.NET