SqlDataReader.NextResultAsync(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.
Een asynchrone versie van NextResult(), die de gegevenslezer naar het volgende resultaat leidt bij het lezen van de resultaten van batch-Transact-SQL-instructies.
Het annuleringstoken kan worden gebruikt om aan te vragen dat de bewerking wordt afgelaten voordat de time-out van de opdracht is verstreken. Uitzonderingen worden gerapporteerd via het geretourneerde taakobject.
public:
override System::Threading::Tasks::Task<bool> ^ NextResultAsync(System::Threading::CancellationToken cancellationToken);public override System.Threading.Tasks.Task<bool> NextResultAsync(System.Threading.CancellationToken cancellationToken);override this.NextResultAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>Public Overrides Function NextResultAsync (cancellationToken As CancellationToken) As Task(Of Boolean)Parameters
- cancellationToken
- CancellationToken
De annuleringsinstructie.
Retouren
Een taak die de asynchrone bewerking vertegenwoordigt.
Uitzonderingen
Meer dan één keer aanroepen NextResultAsync(CancellationToken) voor hetzelfde exemplaar voordat de taak is voltooid.
Context Connection=true is opgegeven in de verbindingsreeks.
SQL Server een fout geretourneerd tijdens het uitvoeren van de opdrachttekst.
Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.
Opmerkingen
Zie Asynchrone programmering voor meer informatie over asynchrone programmering in het .NET Framework Data Provider voor SQL Server.
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 NextResult()de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.