SqlDataReader.ReadAsync(CancellationToken) SqlDataReader.ReadAsync(CancellationToken) SqlDataReader.ReadAsync(CancellationToken) Method

Definition

Eine asynchrone Version von Read(), die den SqlDataReader auf den nächsten Datensatz wechselt.An asynchronous version of Read(), which advances the SqlDataReader to the next record.

Das Abbruchtoken kann verwendet werden, um anzufordern, dass der Vorgang abgebrochen wird, bevor das Timeout des Befehls abläuft.The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Ausnahmen werden über das zurückgegebene Aufgabenobjekt gemeldet.Exceptions will be reported via the returned Task object.

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>

Parameter

cancellationToken
CancellationToken CancellationToken CancellationToken

Die Abbruchanweisung.The cancellation instruction.

Gibt zurück

Eine Aufgabe, die den asynchronen Vorgang darstellt.A task representing the asynchronous operation.

Ausnahmen

ReadAsync(CancellationToken) wird vor dem Abschluss der Aufgabe mehrmals für dieselbe Instanz aufgerufen.Calling ReadAsync(CancellationToken) more than once for the same instance before task completion.

Context Connection=true ist in der Verbindungszeichenfolge angegeben.Context Connection=true is specified in the connection string.

SQL Server hat beim Ausführen des Befehlstexts einen Fehler zurückgegeben.SQL Server returned an error while executing the command text.

Hinweise

Wenn der behavior -Parameter ExecuteReaderAsync von auf Defaultfestgelegt ReadAsync wird, liest die gesamte Zeile, bevor die Aufgabe zurückgegeben wird.If the behavior parameter of ExecuteReaderAsync is set to Default, ReadAsync reads the entire row before returning the Task.

Weitere Informationen, einschließlich Codebeispielen, Informationen zur asynchronen Programmierung in der .NET Framework Datenanbieter für SQL Server finden Sie unter asynchrone Programmierung.For more information, including code samples, about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

Gilt für:

Siehe auch