DbCommand.ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) Methode

Definition

Anbieter sollten diese Methode implementieren, um eine nicht standardmäßige Implementierung für ExecuteReader-Überladungen bereitzustellen.Providers should implement this method to provide a non-default implementation for ExecuteReader overloads.

Die Standardimplementierung ruft die synchrone ExecuteReader()-Methode auf und gibt eine abgeschlossene Aufgabe zurück. Der aufrufende Thread wird blockiert.The default implementation invokes the synchronous ExecuteReader() method and returns a completed task, blocking the calling thread. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn sie einen bereits abgebrochenen Abbruchtoken erhalten hat.The default implementation will return a cancelled task if passed an already cancelled cancellation token. Die Ausnahmen, die von ExecuteReader ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft übermittelt.Exceptions thrown by ExecuteReader will be communicated via the returned Task Exception property.

Diese Methode nimmt ein Abbruchtoken an, das verwendet werden kann, um ein frühes Abbrechen des Vorgangs anzufordern.This method accepts a cancellation token that can be used to request the operation to be cancelled early. Implementierungen können diese Anforderung ignorieren.Implementations may ignore this request.

protected:
 virtual System::Threading::Tasks::Task<System::Data::Common::DbDataReader ^> ^ ExecuteDbDataReaderAsync(System::Data::CommandBehavior behavior, System::Threading::CancellationToken cancellationToken);
protected virtual System.Threading.Tasks.Task<System.Data.Common.DbDataReader> ExecuteDbDataReaderAsync (System.Data.CommandBehavior behavior, System.Threading.CancellationToken cancellationToken);
abstract member ExecuteDbDataReaderAsync : System.Data.CommandBehavior * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.Common.DbDataReader>
override this.ExecuteDbDataReaderAsync : System.Data.CommandBehavior * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.Common.DbDataReader>

Parameter

behavior
CommandBehavior

Optionen zur Ausführung der Anweisung und zum Datenabruf.Options for statement execution and data retrieval.

cancellationToken
CancellationToken

Ein Token zum Abbrechen des asynchronen Vorgangs.A token to cancel the asynchronous operation.

Gibt zurück

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

Ausnahmen

Ein Fehler, der beim Ausführen des Befehlstextes aufgetreten ist.An error occurred while executing the command text.

Ein ungültiger CommandBehavior-Wert.An invalid CommandBehavior value.

Hinweise

Weitere Informationen zur asynchronen Programmierung finden Sie unter asynchrone Programmierung.For more information about asynchronous programming, see Asynchronous Programming.

Gilt für:

Siehe auch