SqlBatch.ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) Метод

Определение

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

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

Пакет:: Microsoft.Data.SqlClient v7.1.0

Пакет:: Microsoft.Data.SqlClient v5.2.0

Пакет:: Microsoft.Data.SqlClient v6.0.2

Пакет:: Microsoft.Data.SqlClient v6.1.3

Пакет:: Microsoft.Data.SqlClient v7.0.3

Исходный код:: SqlBatch.cs

Важно!

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

Эта реализация вызывает ExecuteReaderAsync() метод и возвращает завершенную задачу. Реализация по умолчанию возвращает отмененную задачу при передаче уже отмененного маркера отмены. Этот метод принимает маркер отмены, который можно использовать для запроса на отмену операции раньше.

protected:
 virtual System::Threading::Tasks::Task<System::Data::Common::DbDataReader ^> ^ ExecuteDbDataReaderAsync(System::Data::CommandBehavior behavior, System::Threading::CancellationToken cancellationToken);

protected:
 override System::Threading::Tasks::Task<System::Data::Common::DbDataReader ^> ^ ExecuteDbDataReaderAsync(System::Data::CommandBehavior behavior, System::Threading::CancellationToken cancellationToken);

protected virtual System.Threading.Tasks.Task<System.Data.Common.DbDataReader> ExecuteDbDataReaderAsync(System.Data.CommandBehavior behavior, System.Threading.CancellationToken cancellationToken);

protected override System.Threading.Tasks.Task<System.Data.Common.DbDataReader> ExecuteDbDataReaderAsync(System.Data.CommandBehavior behavior, System.Threading.CancellationToken cancellationToken);

abstract member ExecuteDbDataReaderAsync : System.Data.CommandBehavior * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.Common.DbDataReader>
override this.ExecuteDbDataReaderAsync : System.Data.CommandBehavior * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.Common.DbDataReader>

override this.ExecuteDbDataReaderAsync : System.Data.CommandBehavior * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.Common.DbDataReader>

Protected Overridable Function ExecuteDbDataReaderAsync (behavior As CommandBehavior, cancellationToken As CancellationToken) As Task(Of DbDataReader)

Protected Overrides Function ExecuteDbDataReaderAsync (behavior As CommandBehavior, cancellationToken As CancellationToken) As Task(Of DbDataReader)

Параметры

behavior: CommandBehavior

Экземпляр, указывающий CommandBehaviorпараметры для пакетного выполнения и извлечения данных. Поддерживается только SequentialAccess на CloseConnection уровне пакета.

cancellationToken: CancellationToken

Маркер для отмены асинхронной операции.

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

Task<DbDataReader>

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

Исключения

OperationCanceledException

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

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

Note

Этот метод имеет преимущества от ExecuteReaderAsync(CancellationToken)и все ожидаемые исключения этого метода также применяются здесь.

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