DbCommand.ExecuteScalarAsync Método

Definición

Implementa la versión asincrónica de ExecuteScalar(), pero devuelve Task sincrónicamente, bloqueando el subproceso de llamada.Implements the asynchronous version of ExecuteScalar(), but returns a Task synchronously, blocking the calling thread.

Sobrecargas

ExecuteScalarAsync()

Una versión asincrónica de ExecuteScalar() que ejecuta la consulta y devuelve la primera columna de la primera fila del conjunto de resultados que devuelve la consulta.An asynchronous version of ExecuteScalar(), which executes the query and returns the first column of the first row in the result set returned by the query. Se omiten todas las demás columnas y filas.All other columns and rows are ignored.

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

ExecuteScalarAsync(CancellationToken)

Esta es la versión asincrónica de ExecuteScalar().This is the asynchronous version of ExecuteScalar(). 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 ExecuteScalar() y devuelve una tarea completada, bloqueando el subproceso de llamada.The default implementation invokes the synchronous ExecuteScalar() 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 ExecuteScalar se comunicarán mediante la propiedad Task Exception devuelta.Exceptions thrown by ExecuteScalar 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.

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.

ExecuteScalarAsync()

Una versión asincrónica de ExecuteScalar() que ejecuta la consulta y devuelve la primera columna de la primera fila del conjunto de resultados que devuelve la consulta.An asynchronous version of ExecuteScalar(), which executes the query and returns the first column of the first row in the result set returned by the query. Se omiten todas las demás columnas y filas.All other columns and rows are ignored.

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

public:
 System::Threading::Tasks::Task<System::Object ^> ^ ExecuteScalarAsync();
public System.Threading.Tasks.Task<object> ExecuteScalarAsync ();
public System.Threading.Tasks.Task<object?> ExecuteScalarAsync ();
member this.ExecuteScalarAsync : unit -> System.Threading.Tasks.Task<obj>
Public Function ExecuteScalarAsync () As Task(Of Object)

Devoluciones

Task<Object>

Tarea que representa la operación asincrónica.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.

Se aplica a

ExecuteScalarAsync(CancellationToken)

Esta es la versión asincrónica de ExecuteScalar().This is the asynchronous version of ExecuteScalar(). 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 ExecuteScalar() y devuelve una tarea completada, bloqueando el subproceso de llamada.The default implementation invokes the synchronous ExecuteScalar() 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 ExecuteScalar se comunicarán mediante la propiedad Task Exception devuelta.Exceptions thrown by ExecuteScalar 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<System::Object ^> ^ ExecuteScalarAsync(System::Threading::CancellationToken cancellationToken);
public virtual System.Threading.Tasks.Task<object> ExecuteScalarAsync (System.Threading.CancellationToken cancellationToken);
public virtual System.Threading.Tasks.Task<object?> ExecuteScalarAsync (System.Threading.CancellationToken cancellationToken);
abstract member ExecuteScalarAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<obj>
override this.ExecuteScalarAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<obj>
Public Overridable Function ExecuteScalarAsync (cancellationToken As CancellationToken) As Task(Of Object)

Parámetros

cancellationToken
CancellationToken

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

Devoluciones

Task<Object>

Tarea que representa la operación asincrónica.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.

Se aplica a