DbDataSource.OpenConnectionAsync(CancellationToken) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Secara asinkron mengembalikan koneksi baru yang terbuka ke database yang diwakili oleh ini DbDataSource.
public System.Threading.Tasks.ValueTask<System.Data.Common.DbConnection> OpenConnectionAsync(System.Threading.CancellationToken cancellationToken = default);
member this.OpenConnectionAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Data.Common.DbConnection>
Public Function OpenConnectionAsync (Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of DbConnection)
Parameter
- cancellationToken
- CancellationToken
Token untuk membatalkan operasi asinkron.
Mengembalikan
Koneksi baru yang terbuka ke database yang diwakili oleh ini DbDataSource.
Pengecualian
Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.
Keterangan
Koneksi yang dikembalikan sudah terbuka, dan siap untuk segera digunakan.
Penelepon bertanggung jawab untuk membuang koneksi yang dikembalikan dengan metode ini dengan benar. Kegagalan untuk melakukannya dapat mengakibatkan kebocoran koneksi.
Metode ini disimpan dalam tugas yang menampilkan 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 OpenConnection().