SqlConnection.OpenAsync(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 Open(), waarmee een databaseverbinding wordt geopend met de eigenschapsinstellingen die zijn opgegeven door de ConnectionString. Het annuleringstoken kan worden gebruikt om aan te vragen dat de bewerking wordt afgelaten voordat de time-out van de verbinding is verstreken. Uitzonderingen worden doorgegeven via de geretourneerde taak. Als de time-outtijd van de verbinding is verstreken zonder verbinding te maken, wordt de geretourneerde taak gemarkeerd als fout met een uitzondering. De implementatie retourneert een taak zonder de aanroepende thread te blokkeren voor zowel gegroepeerde als niet-poolverbindingen.
public:
override System::Threading::Tasks::Task ^ OpenAsync(System::Threading::CancellationToken cancellationToken);public override System.Threading.Tasks.Task OpenAsync(System.Threading.CancellationToken cancellationToken);override this.OpenAsync : System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Overrides Function OpenAsync (cancellationToken As CancellationToken) As TaskParameters
- cancellationToken
- CancellationToken
De annuleringsinstructie.
Retouren
Een taak die de asynchrone bewerking vertegenwoordigt.
Uitzonderingen
Meer dan één keer aanroepen OpenAsync(CancellationToken) voor hetzelfde exemplaar voordat de taak is voltooid.
Context Connection=true is opgegeven in de verbindingsreeks.
Er is geen verbinding beschikbaar vanuit de verbindingsgroep voordat de time-out van de verbinding is verstreken.
Eventuele fouten die worden geretourneerd door SQL Server die zijn opgetreden tijdens het openen van de verbinding.
Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.
Opmerkingen
Nadat u bent aangeroepen OpenAsync, State moet u terugkeren Connecting totdat het geretourneerde Task bestand is voltooid. Als de verbinding is geslaagd, State moet u vervolgens terugkeren Open. Als de verbinding mislukt, State moet u terugkeren Closed.
Een oproep om Close de bijbehorende OpenAsync oproep te annuleren of te sluiten.
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 Open()de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.