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