Freigeben über


SqlBatch.ExecuteScalarAsync(CancellationToken) Methode

Definition

Eine asynchrone Version von ExecuteScalar(), die den Batch ausführt und die erste Spalte der ersten Zeile im ersten zurückgegebenen Resultset zurückgibt. Alle anderen Spalten, Zeilen und Resultsets werden ignoriert.

public override System.Threading.Tasks.Task<object> ExecuteScalarAsync (System.Threading.CancellationToken cancellationToken = default);
override this.ExecuteScalarAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<obj>
Public Overrides Function ExecuteScalarAsync (Optional cancellationToken As CancellationToken = Nothing) As Task(Of Object)

Parameter

cancellationToken
CancellationToken

Ein Token zum Abbrechen des asynchronen Vorgangs.

Gibt zurück

Die erste Spalte der ersten Zeile im ersten Resultset.

Ausnahmen

Fehler beim Ausführen des Batches.

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Diese Methode profitiert von ExecuteScalarAsync(CancellationToken), und alle erwarteten Ausnahmen dieser Methode gelten auch hier. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst.

Gilt für: