DbCommand.ExecuteNonQueryAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Этот метод реализует асинхронную версию метода ExecuteNonQuery(), но возвращает объект Task синхронно, блокируя вызывающий поток.
Перегрузки
| ExecuteNonQueryAsync(CancellationToken) |
Это асинхронная версия метода ExecuteNonQuery(). Поставщики должны выполнить переопределение с помощью соответствующей реализации. При необходимости можно игнорировать токен отмены. Реализация по умолчанию вызывает синхронный метод ExecuteNonQuery() и возвращает завершенную задачу, блокируя вызывающий поток. Реализация по умолчанию возвращает отмененную задачу, если ей передается уже отмененный токен отмены. Исключения, создаваемые ExecuteNonQuery(), будут связаны через возвращаемое свойство исключения задачи. Не вызывайте другие методы и свойства объекта |
| ExecuteNonQueryAsync() |
Асинхронная версия ExecuteNonQuery(), которая выполняет команду для объекта соединения, возвращая количество затронутых строк. Вызывает ExecuteNonQueryAsync(CancellationToken) с CancellationToken.None. |
Комментарии
Дополнительные сведения об асинхронном программировании см. в разделе Асинхронное программирование.
ExecuteNonQueryAsync(CancellationToken)
- Исходный код:
- DbCommand.cs
- Исходный код:
- DbCommand.cs
- Исходный код:
- DbCommand.cs
Это асинхронная версия метода 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()
- Исходный код:
- DbCommand.cs
- Исходный код:
- DbCommand.cs
- Исходный код:
- DbCommand.cs
Асинхронная версия 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().
