DbConnection.ChangeDatabaseAsync(String, 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.
Hiermee wijzigt u de huidige database asynchroon voor een geopende verbinding.
public virtual System.Threading.Tasks.Task ChangeDatabaseAsync(string databaseName, System.Threading.CancellationToken cancellationToken = default);abstract member ChangeDatabaseAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.ChangeDatabaseAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Overridable Function ChangeDatabaseAsync (databaseName As String, Optional cancellationToken As CancellationToken = Nothing) As TaskParameters
- databaseName
- String
De naam van de database voor de verbinding die moet worden gebruikt.
- cancellationToken
- CancellationToken
Een optioneel token om de asynchrone bewerking te annuleren. De standaardwaarde is None.
Retouren
Een taak die de asynchrone bewerking vertegenwoordigt.
Uitzonderingen
Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.
Opmerkingen
De waarde die in de databaseName parameter wordt opgegeven, moet een geldige databasenaam zijn voor het huidige exemplaar.
De standaard implementatie van deze asynchrone methode delegeert naar zijn synchrone tegenhanger en retourneert een voltooide Task, mogelijk blokkerende thread.
Gegevensproviders die asynchrone programmering ondersteunen, moeten de standaard implementatie overschrijven met behulp van asynchrone I/O-bewerkingen.
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 ChangeDatabase(String)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.