Freigeben über


SqlBatch.ExecuteNonQueryAsync(CancellationToken) Methode

Definition

Dies ist die asynchrone Version von ExecuteNonQuery().

Die Implementierung ruft die ExecuteNonQueryAsync(CancellationToken) -Methode auf und gibt eine abgeschlossene Aufgabe zurück. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn sie einen bereits abgebrochenen Abbruchtoken erhalten hat.

Rufen Sie keine anderen Methoden und Eigenschaften des DbCommand-Objekts auf, bis die zurückgegebene Aufgabe abgeschlossen ist.

public override System.Threading.Tasks.Task<int> ExecuteNonQueryAsync (System.Threading.CancellationToken cancellationToken = default);
override this.ExecuteNonQueryAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>
Public Overrides Function ExecuteNonQueryAsync (Optional cancellationToken As CancellationToken = Nothing) As Task(Of Integer)

Parameter

cancellationToken
CancellationToken

Ein Token zum Abbrechen des asynchronen Vorgangs.

Gibt zurück

Eine Aufgabe, die den asynchronen Vorgang darstellt.

Ausnahmen

Beim Ausführen des Batches ist ein Fehler aufgetreten.

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

Hinweise

Weitere Informationen zur asynchronen Programmierung finden Sie unter Asynchrone Programmierung.

Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst.

Hinweis

Diese Methode profitiert von ExecuteNonQueryAsync(CancellationToken), und alle erwarteten Ausnahmen dieser Methode gelten auch hier.

Gilt für:

Weitere Informationen