DbCommand.ExecuteScalarAsync DbCommand.ExecuteScalarAsync DbCommand.ExecuteScalarAsync DbCommand.ExecuteScalarAsync Method

Definition

Implementiert die asynchrone Version von ExecuteScalar(), gibt aber Task synchron zurück, wobei der aufrufende Thread blockiert wird.Implements the asynchronous version of ExecuteScalar(), but returns a Task synchronously, blocking the calling thread.

Überlädt

ExecuteScalarAsync(CancellationToken) ExecuteScalarAsync(CancellationToken) ExecuteScalarAsync(CancellationToken)

Dies ist die asynchrone Version von ExecuteScalar().This is the asynchronous version of ExecuteScalar(). Anbieter sollten mit einer entsprechenden Implementierung überschreiben.Providers should override with an appropriate implementation. Das Abbruchtoken kann optional ignoriert werden.The cancellation token may optionally be ignored.

Die Standardimplementierung ruft die synchrone ExecuteScalar()-Methode auf und gibt eine abgeschlossene Aufgabe zurück. Der aufrufende Thread wird blockiert.The default implementation invokes the synchronous ExecuteScalar() method and returns a completed task, blocking the calling thread. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn sie einen bereits abgebrochenen Abbruchtoken erhalten hat.The default implementation will return a cancelled task if passed an already cancelled cancellation token. Die Ausnahmen, die von ExecuteReader ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft übermittelt.Exceptions thrown by ExecuteScalar will be communicated via the returned Task Exception property.

Rufen Sie keine anderen Methoden und Eigenschaften des DbCommand-Objekts auf, bis die zurückgegebene Aufgabe abgeschlossen ist.Do not invoke other methods and properties of the DbCommand object until the returned Task is complete.

ExecuteScalarAsync() ExecuteScalarAsync() ExecuteScalarAsync() ExecuteScalarAsync()

Eine asynchrone Version von ExecuteScalar(), die die Abfrage ausführt und die erste Spalte der ersten Zeile im Resultset zurückgibt.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. Alle anderen Spalten und Zeilen werden ignoriert.All other columns and rows are ignored.

Ruft ExecuteScalarAsync(CancellationToken) mit CancellationToken.None auf.Invokes ExecuteScalarAsync(CancellationToken) with CancellationToken.None.

Hinweise

Weitere Informationen zur asynchronen Programmierung finden Sie unter der asynchronen Programmierung.For more information about asynchronous programming, see Asynchronous Programming.

ExecuteScalarAsync(CancellationToken) ExecuteScalarAsync(CancellationToken) ExecuteScalarAsync(CancellationToken)

Dies ist die asynchrone Version von ExecuteScalar().This is the asynchronous version of ExecuteScalar(). Anbieter sollten mit einer entsprechenden Implementierung überschreiben.Providers should override with an appropriate implementation. Das Abbruchtoken kann optional ignoriert werden.The cancellation token may optionally be ignored.

Die Standardimplementierung ruft die synchrone ExecuteScalar()-Methode auf und gibt eine abgeschlossene Aufgabe zurück. Der aufrufende Thread wird blockiert.The default implementation invokes the synchronous ExecuteScalar() method and returns a completed task, blocking the calling thread. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn sie einen bereits abgebrochenen Abbruchtoken erhalten hat.The default implementation will return a cancelled task if passed an already cancelled cancellation token. Die Ausnahmen, die von ExecuteReader ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft übermittelt.Exceptions thrown by ExecuteScalar will be communicated via the returned Task Exception property.

Rufen Sie keine anderen Methoden und Eigenschaften des DbCommand-Objekts auf, bis die zurückgegebene Aufgabe abgeschlossen ist.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);
abstract member ExecuteScalarAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<obj>
override this.ExecuteScalarAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<obj>

Parameter

cancellationToken
CancellationToken CancellationToken CancellationToken CancellationToken

Das Token zum überwachen von Abbruchanforderungen.The token to monitor for cancellation requests.

Gibt zurück

Eine Aufgabe, die den asynchronen Vorgang darstellt.A task representing the asynchronous operation.

Ausnahmen

Ein Fehler, der beim Ausführen des Befehlstextes aufgetreten ist.An error occurred while executing the command text.

Hinweise

Weitere Informationen zur asynchronen Programmierung finden Sie unter der asynchronen Programmierung.For more information about asynchronous programming, see Asynchronous Programming.

Siehe auch

ExecuteScalarAsync() ExecuteScalarAsync() ExecuteScalarAsync() ExecuteScalarAsync()

Eine asynchrone Version von ExecuteScalar(), die die Abfrage ausführt und die erste Spalte der ersten Zeile im Resultset zurückgibt.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. Alle anderen Spalten und Zeilen werden ignoriert.All other columns and rows are ignored.

Ruft ExecuteScalarAsync(CancellationToken) mit CancellationToken.None auf.Invokes ExecuteScalarAsync(CancellationToken) with CancellationToken.None.

public:
 System::Threading::Tasks::Task<System::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)

Gibt zurück

Eine Aufgabe, die den asynchronen Vorgang darstellt.A task representing the asynchronous operation.

Ausnahmen

Ein Fehler, der beim Ausführen des Befehlstextes aufgetreten ist.An error occurred while executing the command text.

Hinweise

Weitere Informationen zur asynchronen Programmierung finden Sie unter der asynchronen Programmierung.For more information about asynchronous programming, see Asynchronous Programming.

Siehe auch

Gilt für: