SqlConnection.OpenAsync(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.
Versi asinkron dari Open(), yang membuka koneksi database dengan pengaturan properti yang ditentukan oleh ConnectionString. Token pembatalan dapat digunakan untuk meminta agar operasi ditinggalkan sebelum batas waktu koneksi berlalu. Pengecualian akan disebarluaskan melalui Tugas yang dikembalikan. Jika waktu habis koneksi berlalu tanpa berhasil menyambungkan, Tugas yang dikembalikan akan ditandai sebagai rusak dengan Pengecualian. Implementasi mengembalikan Tugas tanpa memblokir utas panggilan untuk koneksi yang dikumpulkan dan tidak terkumpul.
public:
override System::Threading::Tasks::Task ^ OpenAsync(System::Threading::CancellationToken cancellationToken);public override System.Threading.Tasks.Task OpenAsync (System.Threading.CancellationToken cancellationToken);override this.OpenAsync : System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Overrides Function OpenAsync (cancellationToken As CancellationToken) As TaskParameter
- cancellationToken
- CancellationToken
Instruksi pembatalan.
Mengembalikan
Tugas yang mewakili operasi asinkron.
Pengecualian
Memanggil OpenAsync(CancellationToken) lebih dari sekali untuk instans yang sama sebelum penyelesaian tugas.
Context Connection=trueditentukan dalam string koneksi.
Koneksi tidak tersedia dari kumpulan koneksi sebelum waktu koneksi habis berlalu.
Kesalahan apa pun yang dikembalikan oleh SQL Server yang terjadi saat membuka koneksi.
Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.
Keterangan
Setelah memanggil OpenAsync, State harus kembali Connecting hingga pengembalian Task selesai. Kemudian, jika koneksi berhasil, State harus mengembalikan Open. Jika koneksi gagal, State harus mengembalikan Closed.
Panggilan ke Close akan mencoba membatalkan atau menutup panggilan yang OpenAsync sesuai.
Untuk informasi selengkapnya tentang pemrograman asinkron di Penyedia Data .NET Framework untuk SQL Server, lihat Pemrograman 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 Open().
