SqlCommand.ExecuteReaderAsync Метод

Определение

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

Microsoft.Data.SqlClient

Сборка:

Microsoft.Data.SqlClient.dll

Пакет:

Microsoft.Data.SqlClient v7.0.1

Перегрузки

Имя	Описание
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.

ExecuteReaderAsync()

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

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)

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

Task<SqlDataReader>

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

Исключения

InvalidCastException

• Значение SqlDbType , отличное Binary от или VarBinary используемое, если Value задано значение Stream. Дополнительные сведения о потоковой передаче см. в разделе "Поддержка потоковой передачи SqlClient".
• ЗначениеSqlDbType, отличное от Char, NChar, NVarCharVarCharили Xml использовалось при Value установкеTextReader.
• Значение SqlDbType , отличное от Xml используемого при Value установке XmlReader.

ArgumentException

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

InvalidOperationException

• Вызов ExecuteReaderAsync() нескольких раз для одного экземпляра перед завершением задачи.
• Закрытый SqlConnection или удаленный во время операции потоковой передачи. Дополнительные сведения о потоковой передаче см. в разделе "Поддержка потоковой передачи SqlClient".

SqlException

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

IOException

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

ObjectDisposedException

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

Комментарии

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

Note

Для длительных запросов на сервере рекомендуется использовать ExecuteReader из-за известной проблемы с отменой запросов с помощью маркера отмены. Кроме того, рекомендуется отменить выполнение с помощью Cancel метода.

ExecuteReaderAsync(CommandBehavior)

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

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) считывает всю строку перед возвратом полной задачи.

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

Task<SqlDataReader>

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

Исключения

InvalidCastException

• Значение SqlDbType , отличное Binary от или VarBinary используемое, если Value задано значение Stream. Дополнительные сведения о потоковой передаче см. в разделе "Поддержка потоковой передачи SqlClient".
• ЗначениеSqlDbType, отличное от Char, NChar, NVarCharVarCharили Xml использовалось при Value установкеTextReader.
• Значение SqlDbType , отличное от Xml используемого при Value установке XmlReader.

ArgumentException

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

InvalidOperationException

• Вызов ExecuteReaderAsync(CommandBehavior) нескольких раз для одного экземпляра перед завершением задачи.
• SqlConnection закрыт или удален во время операции потоковой передачи. Дополнительные сведения о потоковой передаче см. в разделе "Поддержка потоковой передачи SqlClient".

SqlException

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

IOException

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

ObjectDisposedException

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

Комментарии

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

ExecuteReaderAsync(CancellationToken)

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

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

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

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

Task<SqlDataReader>

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

Исключения

InvalidCastException

• Значение SqlDbType , отличное Binary от или VarBinary используемое, если Value задано значение Stream. Дополнительные сведения о потоковой передаче см. в разделе "Поддержка потоковой передачи SqlClient".
• ЗначениеSqlDbType, отличное от Char, NChar, NVarCharVarCharили Xml использовалось при Value установкеTextReader.
• Значение SqlDbType , отличное от Xml используемого при Value установке XmlReader.

ArgumentException

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

InvalidOperationException

• Вызов ExecuteReaderAsync(CommandBehavior, CancellationToken) нескольких раз для одного экземпляра перед завершением задачи.
• Закрытый SqlConnection или удаленный во время операции потоковой передачи. Дополнительные сведения о потоковой передаче см. в разделе "Поддержка потоковой передачи SqlClient".

SqlException

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

IOException

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

ObjectDisposedException

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

Комментарии

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

ExecuteReaderAsync(CommandBehavior, CancellationToken)

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

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

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

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

Task<SqlDataReader>

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

Исключения

InvalidCastException

• Значение SqlDbType , отличное Binary от или VarBinary используемое, если Value задано значение Stream. Дополнительные сведения о потоковой передаче см. в разделе "Поддержка потоковой передачи SqlClient".
• ЗначениеSqlDbType, отличное от Char, NChar, NVarCharVarCharили Xml использовалось при Value установкеTextReader.
• Значение SqlDbType , отличное от Xml используемого при Value установке XmlReader.

ArgumentException

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

InvalidOperationException

• Вызов ExecuteReaderAsync(CommandBehavior, CancellationToken) нескольких раз для одного экземпляра перед завершением задачи.
• Закрытый SqlConnection или удаленный во время операции потоковой передачи. Дополнительные сведения о потоковой передаче см. в разделе "Поддержка потоковой передачи SqlClient".

SqlException

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

IOException

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

ObjectDisposedException

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

Комментарии

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