DbCommand.ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Providers moeten deze methode implementeren om een niet-standaard implementatie te bieden voor ExecuteReader overbelastingen.
De standaardimplementatie roept de synchrone ExecuteReader() methode aan en retourneert een voltooide taak, waardoor de aanroepende thread wordt geblokkeerd. De standaardimplementatie retourneert een geannuleerde taak als een al geannuleerd annuleringstoken is doorgegeven. Uitzonderingen die door ExecuteReader worden gegenereerd, worden gecommuniceerd via de geretourneerde eigenschap Taakuitzondering.
Deze methode accepteert een annuleringstoken dat kan worden gebruikt om de bewerking vroeg te annuleren. Implementaties kunnen deze aanvraag negeren.
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>Protected Overridable Function ExecuteDbDataReaderAsync (behavior As CommandBehavior, cancellationToken As CancellationToken) As Task(Of DbDataReader)Parameters
- behavior
- CommandBehavior
Een exemplaar van, waarbij opties worden opgegeven voor het uitvoeren van CommandBehavioropdrachten en het ophalen van gegevens.
- cancellationToken
- CancellationToken
Een token om de asynchrone bewerking te annuleren.
Retouren
Een taak die de asynchrone bewerking vertegenwoordigt.
Uitzonderingen
Er is een fout opgetreden tijdens het uitvoeren van de opdracht.
Een ongeldige CommandBehavior waarde.
Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.
Opmerkingen
Zie Asynchrone programmering voor meer informatie over asynchrone programmering.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door ExecuteDbDataReader(CommandBehavior)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.