SqlBatch.ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Эта реализация вызывает ExecuteReaderAsync() метод и возвращает завершенную задачу. Реализация по умолчанию возвращает отмененную задачу, если ей передается уже отмененный токен отмены.
Этот метод принимает токен отмены, который может использоваться для запроса ранней отмены операции.
protected:
override 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);
override this.ExecuteDbDataReaderAsync : System.Data.CommandBehavior * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.Common.DbDataReader>
Protected Overrides Function ExecuteDbDataReaderAsync (behavior As CommandBehavior, cancellationToken As CancellationToken) As Task(Of DbDataReader)
Параметры
- behavior
- CommandBehavior
Одно из значений перечисления, указывающее параметры пакетного выполнения и извлечения данных.
- cancellationToken
- CancellationToken
Токен для отмены асинхронной операции.
Возвращаемое значение
Задача, представляющая асинхронную операцию.
Исключения
Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.
Комментарии
Дополнительные сведения об асинхронном программировании см. в разделе Асинхронное программирование.
Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые ExecuteDbDataReader(CommandBehavior).
Примечание
Этот метод выигрывает от ExecuteReaderAsync(CancellationToken), и здесь также применяются все ожидаемые исключения этого метода.