DbConnection.ChangeDatabaseAsync(String, CancellationToken) Metódus
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Aszinkron módon módosítja az aktuális adatbázist egy nyitott kapcsolathoz.
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 TaskParaméterek
- databaseName
- String
A használni kívánt kapcsolat adatbázisának neve.
- cancellationToken
- CancellationToken
Nem kötelező jogkivonat az aszinkron művelet megszakításához. Az alapértelmezett érték a None.
Válaszok
Az aszinkron műveletet képviselő feladat.
Kivételek
A lemondási jogkivonat megszakadt. Ezt a kivételt a rendszer a visszaadott tevékenységben tárolja.
Megjegyzések
A paraméterben databaseName megadott értéknek érvényes adatbázisnévnek kell lennie az aktuális példányhoz.
Ennek az aszinkron metódusnak az alapértelmezett implementációja a szinkron megfelelőjéhez delegál, és egy befejezett , potenciálisan a hívó szálat blokkoló befejezett Taskértéket ad vissza.
Az aszinkron programozást támogató adatszolgáltatóknak felül kell bírálnia az alapértelmezett implementációt aszinkron I/O-műveletek használatával.
Ez a metódus a feladatban tárolja az összes olyan nem használati kivételt, amelyet a metódus szinkron megfelelője tud dobni. Ha egy kivételt tárol a visszaadott tevékenységben, akkor a rendszer akkor küldi el a kivételt, amikor a feladatra vár. A használati kivételek(például ArgumentException) továbbra is szinkron módon jelennek meg. A tárolt kivételekről lásd a következő által ChangeDatabase(String)kiadott kivételeket: .
