DbConnection.OpenAsync Metode

Definisi

Ruang nama:

System.Data.Common

Rakitan:

System.Data.Common.dll

Metode ini mengimplementasikan versi asinkron dari Open().

Overload

OpenAsync()

Versi asinkron dari Open(), yang membuka koneksi database dengan pengaturan yang ditentukan oleh ConnectionString. Metode ini memanggil metode OpenAsync(CancellationToken) virtual dengan CancellationToken.None.

OpenAsync(CancellationToken)

Ini adalah versi asinkron dari Open(). Penyedia harus mengambil alih dengan implementasi yang sesuai. Token pembatalan dapat secara opsional dihormati. Implementasi default memanggil panggilan sinkron Open() dan mengembalikan tugas yang telah selesai. Implementasi default akan mengembalikan tugas yang dibatalkan jika melewati cancellationToken yang sudah dibatalkan. Pengecualian yang dilemparkan oleh Buka akan dikomunikasikan melalui properti Pengecualian Tugas yang dikembalikan. Jangan memanggil metode dan properti lain dari DbConnection objek sampai Tugas yang dikembalikan selesai.

Keterangan

Untuk informasi selengkapnya tentang pemrograman asinkron di Penyedia Data .NET Framework untuk SQL Server, lihat Pemrograman Asinkron.

OpenAsync()

Sumber:

DbConnection.cs

Versi asinkron dari Open(), yang membuka koneksi database dengan pengaturan yang ditentukan oleh ConnectionString. Metode ini memanggil metode OpenAsync(CancellationToken) virtual dengan CancellationToken.None.

public:
 System::Threading::Tasks::Task ^ OpenAsync();

public System.Threading.Tasks.Task OpenAsync ();

member this.OpenAsync : unit -> System.Threading.Tasks.Task

Public Function OpenAsync () As Task

Mengembalikan

Task

Tugas yang mewakili operasi asinkron.

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().

Lihat juga

• Ringkasan ADO.NET

OpenAsync(CancellationToken)

Sumber:

DbConnection.cs

Ini adalah versi asinkron dari Open(). Penyedia harus mengambil alih dengan implementasi yang sesuai. Token pembatalan dapat secara opsional dihormati.

Implementasi default memanggil panggilan sinkron Open() dan mengembalikan tugas yang telah selesai. Implementasi default akan mengembalikan tugas yang dibatalkan jika melewati cancellationToken yang sudah dibatalkan. Pengecualian yang dilemparkan oleh Buka akan dikomunikasikan melalui properti Pengecualian Tugas yang dikembalikan.

Jangan memanggil metode dan properti lain dari DbConnection objek sampai Tugas yang dikembalikan selesai.

public:
 virtual System::Threading::Tasks::Task ^ OpenAsync(System::Threading::CancellationToken cancellationToken);

public virtual System.Threading.Tasks.Task OpenAsync (System.Threading.CancellationToken cancellationToken);

abstract member OpenAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.OpenAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overridable Function OpenAsync (cancellationToken As CancellationToken) As Task

Parameter

cancellationToken

CancellationToken

Instruksi pembatalan.

Mengembalikan

Task

Tugas yang mewakili operasi asinkron.

Pengecualian

OperationCanceledException

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().

Lihat juga

• Ringkasan ADO.NET