Freigeben über


SqlDataReader.NextResultAsync(CancellationToken) Methode

Definition

Eine asynchrone Version von NextResult(), die den Datenleser beim Lesen der Ergebnisse von Batch Transact-SQL-Anweisungen zum nächsten Ergebnis weiterversetzt.

Das Abbruchtoken kann verwendet werden, um anzufordern, dass der Vorgang abgebrochen wird, bevor das Timeout des Befehls abläuft. Ausnahmen werden über das zurückgegebene Aufgabenobjekt gemeldet.

public:
 override System::Threading::Tasks::Task<bool> ^ NextResultAsync(System::Threading::CancellationToken cancellationToken);
public override System.Threading.Tasks.Task<bool> NextResultAsync (System.Threading.CancellationToken cancellationToken);
override this.NextResultAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
Public Overrides Function NextResultAsync (cancellationToken As CancellationToken) As Task(Of Boolean)

Parameter

cancellationToken
CancellationToken

Die Abbruchanweisung.

Gibt zurück

Eine Aufgabe, die den asynchronen Vorgang darstellt.

Ausnahmen

NextResultAsync(CancellationToken) wird vor dem Abschluss der Aufgabe mehrmals für dieselbe Instanz aufgerufen.

Context Connection=true ist in der Verbindungszeichenfolge angegeben.

SQL Server hat beim Ausführen des Befehlstexts einen Fehler zurückgegeben.

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

Hinweise

Weitere Informationen zur asynchronen Programmierung im .NET Framework-Datenanbieter für SQL Server finden Sie unter Asynchrone Programmierung.

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. 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. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten NextResult()Ausnahmen.

Gilt für:

Weitere Informationen