DbDataReader.ReadAsync 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.
De lezer wordt asynchroon doorgezet naar de volgende record in een resultatenset.
Overloads
| Name | Description |
|---|---|
| ReadAsync() |
De lezer wordt asynchroon doorgezet naar de volgende record in een resultatenset. |
| ReadAsync(CancellationToken) |
De lezer wordt asynchroon doorgezet naar de volgende record in een resultatenset. |
Opmerkingen
Zie Asynchrone programmering voor meer informatie over asynchrone programmering.
ReadAsync()
De lezer wordt asynchroon doorgezet naar de volgende record in een resultatenset.
public:
System::Threading::Tasks::Task<bool> ^ ReadAsync();public System.Threading.Tasks.Task<bool> ReadAsync();member this.ReadAsync : unit -> System.Threading.Tasks.Task<bool>Public Function ReadAsync () As Task(Of Boolean)Retouren
Een Task<TResult> waarvan Result de eigenschap is true als er meer rijen zijn of false als dat niet zo is.
Uitzonderingen
Er is een fout opgetreden tijdens het uitvoeren van de opdrachttekst.
Opmerkingen
De standaardimplementatie van deze asynchrone methode roept de synchrone tegenhanger aan en retourneert een voltooide taak, waardoor de aanroepende thread mogelijk wordt geblokkeerd.
Gegevensproviders die asynchrone programmering ondersteunen, moeten de standaard implementatie overschrijven met behulp van asynchrone I/O-bewerkingen.
Andere methoden en eigenschappen van het DbDataReader-object mogen niet worden aangeroepen terwijl de geretourneerde taak nog niet is voltooid.
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 Read()de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Zie ook
Van toepassing op
ReadAsync(CancellationToken)
De lezer wordt asynchroon doorgezet naar de volgende record in een resultatenset.
public:
virtual System::Threading::Tasks::Task<bool> ^ ReadAsync(System::Threading::CancellationToken cancellationToken);public virtual System.Threading.Tasks.Task<bool> ReadAsync(System.Threading.CancellationToken cancellationToken);abstract member ReadAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.ReadAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>Public Overridable Function ReadAsync (cancellationToken As CancellationToken) As Task(Of Boolean)Parameters
- cancellationToken
- CancellationToken
De annuleringsinstructie.
Retouren
Een Task<TResult> waarvan Result de eigenschap is true als er meer rijen zijn of false als dat niet zo is.
Uitzonderingen
Er is een fout opgetreden tijdens het uitvoeren van de opdrachttekst.
Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.
Opmerkingen
De standaardimplementatie van deze asynchrone methode roept de synchrone tegenhanger aan en retourneert een voltooide taak, waardoor de aanroepende thread mogelijk wordt geblokkeerd. De standaardimplementatie retourneert ook een geannuleerde taak als een al geannuleerd annuleringstoken is doorgegeven.
Gegevensproviders die asynchrone programmering ondersteunen, moeten de standaard implementatie overschrijven met behulp van asynchrone I/O-bewerkingen.
Deze methode accepteert een annuleringstoken dat kan worden gebruikt om de bewerking vroeg te annuleren. Implementaties kunnen deze aanvraag negeren.
Andere methoden en eigenschappen van het DbDataReader-object mogen niet worden aangeroepen terwijl de geretourneerde taak nog niet is voltooid.
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 Read()de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.