Bagikan melalui


DbConnection.ChangeDatabaseAsync(String, CancellationToken) Metode

Definisi

Secara asinkron mengubah database saat ini untuk koneksi terbuka.

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.Task
Public Overridable Function ChangeDatabaseAsync (databaseName As String, Optional cancellationToken As CancellationToken = Nothing) As Task

Parameter

databaseName
String

Nama database untuk koneksi yang akan digunakan.

cancellationToken
CancellationToken

Token opsional untuk membatalkan operasi asinkron. Nilai defaultnya adalah None.

Mengembalikan

Tugas yang mewakili operasi asinkron.

Pengecualian

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

Keterangan

Nilai yang databaseName disediakan dalam parameter harus merupakan nama database yang valid untuk instans saat ini.

Implementasi default metode asinkron ini mendelegasikan ke rekan sinkronnya dan mengembalikan yang selesai Task, berpotensi memblokir utas panggilan.

Penyedia data yang mendukung pemrograman asinkron harus mengambil alih implementasi default menggunakan operasi I/O asinkron.

Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh ChangeDatabase(String).

Berlaku untuk