SqlDataReader.ReadAsync(CancellationToken) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Eine asynchrone Version von Read(), die den SqlDataReader auf den nächsten Datensatz wechselt.
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> ^ ReadAsync(System::Threading::CancellationToken cancellationToken);public override System.Threading.Tasks.Task<bool> ReadAsync (System.Threading.CancellationToken cancellationToken);override this.ReadAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>Public Overrides Function ReadAsync (cancellationToken As CancellationToken) As Task(Of Boolean)Parameter
- cancellationToken
- CancellationToken
Die Abbruchanweisung.
Gibt zurück
Eine Aufgabe, die den asynchronen Vorgang darstellt.
Ausnahmen
ReadAsync(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
Wenn der behavior Parameter von ExecuteReaderAsync auf Defaultfestgelegt ist, ReadAsync liest die gesamte Zeile, bevor der Task zurückgegeben wird.
Weitere Informationen, einschließlich Codebeispielen, zur asynchronen Programmierung im .NET Framework-Datenanbieter für SQL Server finden Sie unter Asynchrone Programmierung.
Diese Methode speichert in der Aufgabe, die 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. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden Read().
