DbConnection.OpenAsync 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.
Met deze methode wordt een asynchrone versie van Open().
Overloads
| Name | Description |
|---|---|
| OpenAsync() |
Een asynchrone versie van Open(), waarmee een databaseverbinding wordt geopend met de instellingen die zijn opgegeven door de ConnectionString. Met deze methode wordt de virtuele methode OpenAsync(CancellationToken) aangeroepen met CancellationToken.None. |
| OpenAsync(CancellationToken) |
Dit is de asynchrone versie van Open(). Providers moeten overschrijven met een geschikte implementatie. Het annuleringstoken kan eventueel worden gehonoreerd. De standaardimplementatie roept de synchrone aanroep aan Open() en retourneert een voltooide taak. De standaardimplementatie retourneert een geannuleerde taak als er al een geannuleerde cancellationToken is doorgegeven. Uitzonderingen die door Openen worden gegenereerd, worden gecommuniceerd via de geretourneerde eigenschap Taakuitzondering. Roep geen andere methoden en eigenschappen van het |
Opmerkingen
Zie Asynchrone programmering voor meer informatie over asynchrone programmering in het .NET Framework Data Provider voor SQL Server.
OpenAsync()
Een asynchrone versie van Open(), waarmee een databaseverbinding wordt geopend met de instellingen die zijn opgegeven door de ConnectionString. Met deze methode wordt de virtuele methode OpenAsync(CancellationToken) aangeroepen met CancellationToken.None.
public:
System::Threading::Tasks::Task ^ OpenAsync();public System.Threading.Tasks.Task OpenAsync();member this.OpenAsync : unit -> System.Threading.Tasks.TaskPublic Function OpenAsync () As TaskRetouren
Een taak die de asynchrone bewerking vertegenwoordigt.
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.
Zie ook
Van toepassing op
OpenAsync(CancellationToken)
Dit is de asynchrone versie van Open(). Providers moeten overschrijven met een geschikte implementatie. Het annuleringstoken kan eventueel worden gehonoreerd.
De standaardimplementatie roept de synchrone aanroep aan Open() en retourneert een voltooide taak. De standaardimplementatie retourneert een geannuleerde taak als er al een geannuleerde cancellationToken is doorgegeven. Uitzonderingen die door Openen worden gegenereerd, worden gecommuniceerd via de geretourneerde eigenschap Taakuitzondering.
Roep geen andere methoden en eigenschappen van het DbConnection object aan totdat de geretourneerde taak is voltooid.
public:
virtual System::Threading::Tasks::Task ^ OpenAsync(System::Threading::CancellationToken cancellationToken);public virtual System.Threading.Tasks.Task OpenAsync(System.Threading.CancellationToken cancellationToken);abstract member OpenAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.OpenAsync : System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Overridable Function OpenAsync (cancellationToken As CancellationToken) As TaskParameters
- cancellationToken
- CancellationToken
De annuleringsinstructie.
Retouren
Een taak die de asynchrone bewerking vertegenwoordigt.
Uitzonderingen
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.