DbBatch.ExecuteNonQueryAsync(CancellationToken) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Это асинхронная версия ExecuteNonQuery(). Поставщики должны переопределить соответствующую реализацию. Маркер отмены может быть проигнорирован при необходимости.
Реализация по умолчанию вызывает синхронный ExecuteNonQuery() метод и возвращает завершенную задачу, блокируя вызывающий поток. Реализация по умолчанию возвращает отмененную задачу при передаче уже отмененного маркера отмены. Исключения, создаваемые ExecuteNonQuery() путем передачи данных, будут передаваться с помощью возвращаемого свойства "Исключение задачи".
Не вызывайте другие методы и свойства DbCommand объекта до завершения возвращаемой задачи.
public abstract System.Threading.Tasks.Task<int> ExecuteNonQueryAsync(System.Threading.CancellationToken cancellationToken = default);abstract member ExecuteNonQueryAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>Public MustOverride Function ExecuteNonQueryAsync (Optional cancellationToken As CancellationToken = Nothing) As Task(Of Integer)Параметры
- cancellationToken
- CancellationToken
Маркер для отмены асинхронной операции.
Возвращаемое значение
Задача, представляющая асинхронную операцию.
Исключения
Произошла ошибка при выполнении пакета.
Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.
Комментарии
Дополнительные сведения об асинхронном программировании см. в статье "Асинхронное программирование".
Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых ExecuteNonQuery().
