DbCommand.PrepareAsync(CancellationToken) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Асинхронно создает подготовленную (или скомпилированную) версию команды в источнике данных.
public virtual System.Threading.Tasks.Task PrepareAsync (System.Threading.CancellationToken cancellationToken = default);abstract member PrepareAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.PrepareAsync : System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Overridable Function PrepareAsync (Optional cancellationToken As CancellationToken = Nothing) As TaskПараметры
- cancellationToken
- CancellationToken
Необязательный токен для отмены асинхронной операции. Значение по умолчанию — None.
Возвращаемое значение
Task, представляющий асинхронную операцию.
Исключения
Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.
Комментарии
Реализация этого асинхронного метода по умолчанию делегирует своему синхронному аналогу и возвращает завершенный Taskобъект , потенциально блокирующий вызывающий поток.
Поставщики данных, поддерживающие асинхронное программирование , должны переопределить реализацию по умолчанию с помощью асинхронных операций ввода-вывода.
CommandType Если свойство имеет значение TableDirect, PrepareAsync ничего не делает. Если CommandType для задано значение StoredProcedure, вызов должен завершиться PrepareAsync успешно, хотя это может привести к отключению операции.
Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые Prepare().
