SqlCommand.ExecuteReaderAsync Метод

Ссылка

Определение

Пространство имен:: System.Data.SqlClient

Сборка:: System.Data.SqlClient.dll

Сборка:: System.Data.dll

Сборки:: netstandard.dll, System.Data.SqlClient.dll

Пакет:: System.Data.SqlClient v4.8.6

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

Перегрузки

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<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>

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

Исключения

InvalidCastException

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

-или-

Если SqlDbType для параметра задано значение TextReader, кроме Char, NChar, NVarChar, VarChar или Xml, использовался объект , отличный от ValueChar, NChar, NVarChar, VarChar или Xml.

-или-

Объект , отличный SqlDbType от XML , использовался, когда Value для параметра задано значение XmlReader.

ArgumentException

Недопустимое значение CommandBehavior.

InvalidOperationException

Вызов ExecuteReaderAsync() более одного раза для того же экземпляра до завершения задачи.

-или-

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

-или-

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

SqlException

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

-или-

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

IOException

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

ObjectDisposedException

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

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

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

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

Применяется к

ExecuteReaderAsync(CommandBehavior)

Асинхронная версия ExecuteReader(CommandBehavior), которая отправляет CommandText в Connection и создает SqlDataReader. Сведения об исключениях передаются в возвращенном объекте Task.

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>

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

Исключения

InvalidCastException

-или-

Объект , отличный SqlDbType от XML , использовался, когда Value для параметра задано значение XmlReader.

ArgumentException

Недопустимое значение CommandBehavior.

InvalidOperationException

Вызов ExecuteReaderAsync(CommandBehavior) более одного раза для того же экземпляра до завершения задачи.

-или-

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

SqlException

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

-или-

IOException

ObjectDisposedException

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

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

Применяется к

ExecuteReaderAsync(CancellationToken)

Асинхронная версия ExecuteReader(), которая отправляет CommandText в Connection и создает SqlDataReader.

Токен отмены можно использовать для запроса отказа от операции до истечения времени ожидания команды. Сведения об исключениях передаются в возвращенном объекте Task.

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>

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

Исключения

InvalidCastException

-или-

Объект , отличный SqlDbType от XML , использовался, когда Value для параметра задано значение XmlReader.

ArgumentException

Недопустимое значение CommandBehavior.

InvalidOperationException

Вызов ExecuteReaderAsync(CommandBehavior, CancellationToken) более одного раза для того же экземпляра до завершения задачи.

-или-

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

SqlException

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

-или-

IOException

ObjectDisposedException

OperationCanceledException

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

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

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

Применяется к

ExecuteReaderAsync(CommandBehavior, CancellationToken)

Асинхронная версия ExecuteReader(CommandBehavior), которая отправляет CommandText в Connection и создает SqlDataReader.

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

cancellationToken: CancellationToken

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

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

Task<SqlDataReader>

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

Исключения

InvalidCastException

-или-

Объект , отличный SqlDbType от XML , использовался, когда Value для параметра задано значение XmlReader.

ArgumentException

Недопустимое значение CommandBehavior.

InvalidOperationException

Вызов ExecuteReaderAsync(CommandBehavior, CancellationToken) более одного раза для того же экземпляра до завершения задачи.

-или-

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

SqlException

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

-или-

IOException

ObjectDisposedException

OperationCanceledException

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

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

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

Применяется к

Поделиться через

SqlCommand.ExecuteReaderAsync Метод

Определение

Перегрузки

Комментарии

ExecuteReaderAsync()

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

Исключения

Комментарии

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

Применяется к

ExecuteReaderAsync(CommandBehavior)

Параметры

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

Исключения

Комментарии

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

Применяется к

ExecuteReaderAsync(CancellationToken)

Параметры

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

Исключения

Комментарии

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

Применяется к

ExecuteReaderAsync(CommandBehavior, CancellationToken)

Параметры

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

Исключения

Комментарии

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

Применяется к

Дополнительные ресурсы