Freigeben über


SqlDataReader.ReadAsync(CancellationToken) Methode

Definition

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.

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

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.

Hinweis

Beim Lesen großer Daten (Binärdaten/Text) empfiehlt es sich, für eine optimale Leistung zu verwenden Read .

Gilt für: