SqlCommand.ExecuteReaderAsync Метод

Определение

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

System.Data.SqlClient

Сборка:

System.Data.dll

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

Перегрузки

Имя	Описание
ExecuteReaderAsync()	Асинхронная версияExecuteReader(), которая отправляет объект CommandText в и создает Connection объектSqlDataReader. Исключения будут сообщаться с помощью возвращаемого объекта Task.
ExecuteReaderAsync(CommandBehavior)	Асинхронная версия ExecuteReader(CommandBehavior), которая отправляет объект CommandTextConnectionв и создает объект SqlDataReader. Исключения будут сообщаться с помощью возвращаемого объекта Task.
ExecuteReaderAsync(CancellationToken)	Асинхронная версияExecuteReader(), которая отправляет объект CommandText в и создает Connection объектSqlDataReader. Маркер отмены можно использовать для запроса на то, что операция будет прекращена до истечения времени ожидания команды. Исключения будут сообщаться с помощью возвращаемого объекта Task.
ExecuteReaderAsync(CommandBehavior, CancellationToken)	Асинхронная версия ExecuteReader(CommandBehavior), которая отправляет объект CommandTextConnectionв и создает SqlDataReader Маркер отмены можно использовать для запроса на то, что операция будет прекращена до истечения времени ожидания команды. Исключения будут сообщаться с помощью возвращаемого объекта Task.

Комментарии

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

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"Двоичный" или "VarBinary", используется Value значение "ДвоичныйStream" или "VarBinary". Дополнительные сведения о потоковой передаче см. в разделе "Поддержка потоковой передачи SqlClient".

–или–

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

–или–

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

ArgumentException

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

InvalidOperationException

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

–или–

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

–или–

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

SqlException

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

–или–

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

IOException

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

ObjectDisposedException

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

Комментарии

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

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

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

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

ExecuteReaderAsync(CommandBehavior)

Асинхронная версия ExecuteReader(CommandBehavior), которая отправляет объект CommandTextConnectionв и создает объект 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"Двоичный" или "VarBinary", используется Value значение "ДвоичныйStream" или "VarBinary". Дополнительные сведения о потоковой передаче см. в разделе "Поддержка потоковой передачи SqlClient".

–или–

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

–или–

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

ArgumentException

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

InvalidOperationException

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

–или–

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

–или–

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

SqlException

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

–или–

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

IOException

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

ObjectDisposedException

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

Комментарии

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

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

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

• Общие сведения об 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"Двоичный" или "VarBinary", используется Value значение "ДвоичныйStream" или "VarBinary". Дополнительные сведения о потоковой передаче см. в разделе "Поддержка потоковой передачи SqlClient".

–или–

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

–или–

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

ArgumentException

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

InvalidOperationException

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

–или–

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

–или–

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

SqlException

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

–или–

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

IOException

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

ObjectDisposedException

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

OperationCanceledException

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

Комментарии

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

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

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

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

ExecuteReaderAsync(CommandBehavior, CancellationToken)

Асинхронная версия ExecuteReader(CommandBehavior), которая отправляет объект CommandTextConnectionв и создает SqlDataReader

Маркер отмены можно использовать для запроса на то, что операция будет прекращена до истечения времени ожидания команды. Исключения будут сообщаться с помощью возвращаемого объекта Task.

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

Параметры выполнения инструкций и извлечения данных. Если задано значение Default, ReadAsync(CancellationToken) считывает всю строку перед возвратом полной задачи.

cancellationToken

CancellationToken

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

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

Task<SqlDataReader>

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

Исключения

InvalidCastException

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

–или–

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

–или–

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

ArgumentException

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

InvalidOperationException

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

–или–

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

–или–

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

SqlException

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

–или–

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

IOException

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

ObjectDisposedException

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

OperationCanceledException

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

Комментарии

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

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

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

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