DbCommand.ExecuteNonQueryAsync Método

Definición

Este método implementa la versión asincrónica de ExecuteNonQuery(), pero devuelve Task sincrónicamente, bloqueando el subproceso de llamada.This method implements the asynchronous version of ExecuteNonQuery(), but returns a Task synchronously, blocking the calling thread.

Sobrecargas

ExecuteNonQueryAsync(CancellationToken)

Esta es la versión asincrónica de ExecuteNonQuery().This is the asynchronous version of ExecuteNonQuery(). Los proveedores lo deben reemplazar con una implementación apropiada.Providers should override with an appropriate implementation. El token de cancelación se puede omitir opcionalmente.The cancellation token may optionally be ignored.

La implementación predeterminada invoca el método sincrónico ExecuteNonQuery() y devuelve una tarea completada, bloqueando el subproceso de llamada.The default implementation invokes the synchronous ExecuteNonQuery() method and returns a completed task, blocking the calling thread. La implementación predeterminada devolverá una tarea cancelada si se pasa un token de cancelación ya cancelado.The default implementation will return a cancelled task if passed an already cancelled cancellation token. Las excepciones producidas por ExecuteNonQuery() se comunicarán mediante la propiedad Task Exception devuelta.Exceptions thrown by ExecuteNonQuery() will be communicated via the returned Task Exception property.

No invoque otros métodos y propiedades del objeto DbCommand hasta que se haya completado la tarea devuelta.Do not invoke other methods and properties of the DbCommand object until the returned Task is complete.

ExecuteNonQueryAsync()

Una versión asincrónica de ExecuteNonQuery(), que ejecuta una instrucción SQL con un objeto de conexión.An asynchronous version of ExecuteNonQuery(), which executes a SQL statement against a connection object.

Invoca ExecuteNonQueryAsync(CancellationToken) con CancellationToken.None.Invokes ExecuteNonQueryAsync(CancellationToken) with CancellationToken.None.

Comentarios

Para obtener más información sobre la programación asincrónica, vea programación asincrónica.For more information about asynchronous programming, see Asynchronous Programming.

ExecuteNonQueryAsync(CancellationToken)

Esta es la versión asincrónica de ExecuteNonQuery().This is the asynchronous version of ExecuteNonQuery(). Los proveedores lo deben reemplazar con una implementación apropiada.Providers should override with an appropriate implementation. El token de cancelación se puede omitir opcionalmente.The cancellation token may optionally be ignored.

La implementación predeterminada invoca el método sincrónico ExecuteNonQuery() y devuelve una tarea completada, bloqueando el subproceso de llamada.The default implementation invokes the synchronous ExecuteNonQuery() method and returns a completed task, blocking the calling thread. La implementación predeterminada devolverá una tarea cancelada si se pasa un token de cancelación ya cancelado.The default implementation will return a cancelled task if passed an already cancelled cancellation token. Las excepciones producidas por ExecuteNonQuery() se comunicarán mediante la propiedad Task Exception devuelta.Exceptions thrown by ExecuteNonQuery() will be communicated via the returned Task Exception property.

No invoque otros métodos y propiedades del objeto DbCommand hasta que se haya completado la tarea devuelta.Do not invoke other methods and properties of the DbCommand object until the returned Task is complete.

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>

Parámetros

cancellationToken
CancellationToken

Token para cancelar la operación asincrónica.A token to cancel the asynchronous operation.

Devoluciones

Tarea que representa la operación asíncrona.A task representing the asynchronous operation.

Excepciones

Error que se haya producido al ejecutar el texto del comando.An error occurred while executing the command text.

Comentarios

Para obtener más información sobre la programación asincrónica, vea programación asincrónica.For more information about asynchronous programming, see Asynchronous Programming.

Consulte también:

ExecuteNonQueryAsync()

Una versión asincrónica de ExecuteNonQuery(), que ejecuta una instrucción SQL con un objeto de conexión.An asynchronous version of ExecuteNonQuery(), which executes a SQL statement against a connection object.

Invoca ExecuteNonQueryAsync(CancellationToken) con CancellationToken.None.Invokes ExecuteNonQueryAsync(CancellationToken) with 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)

Devoluciones

Tarea que representa la operación asíncrona.A task representing the asynchronous operation.

Excepciones

Error que se haya producido al ejecutar el texto del comando.An error occurred while executing the command text.

Comentarios

Para obtener más información sobre la programación asincrónica, vea programación asincrónica.For more information about asynchronous programming, see Asynchronous Programming.

Consulte también:

Se aplica a