Bagikan melalui


DbCommand.ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) Metode

Definisi

Penyedia harus menerapkan metode ini untuk menyediakan implementasi non-default untuk ExecuteReader kelebihan beban.

Implementasi default memanggil metode sinkron ExecuteReader() dan mengembalikan tugas yang selesai, memblokir utas panggilan. Implementasi default akan mengembalikan tugas yang dibatalkan jika melewati token pembatalan yang sudah dibatalkan. Pengecualian yang dilemparkan oleh ExecuteReader akan dikomunikasikan melalui properti Pengecualian Tugas yang dikembalikan.

Metode ini menerima token pembatalan yang dapat digunakan untuk meminta operasi dibatalkan lebih awal. Implementasi dapat mengabaikan permintaan ini.

protected:
 virtual System::Threading::Tasks::Task<System::Data::Common::DbDataReader ^> ^ ExecuteDbDataReaderAsync(System::Data::CommandBehavior behavior, System::Threading::CancellationToken cancellationToken);
protected virtual System.Threading.Tasks.Task<System.Data.Common.DbDataReader> ExecuteDbDataReaderAsync (System.Data.CommandBehavior behavior, System.Threading.CancellationToken cancellationToken);
abstract member ExecuteDbDataReaderAsync : System.Data.CommandBehavior * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.Common.DbDataReader>
override this.ExecuteDbDataReaderAsync : System.Data.CommandBehavior * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.Common.DbDataReader>
Protected Overridable Function ExecuteDbDataReaderAsync (behavior As CommandBehavior, cancellationToken As CancellationToken) As Task(Of DbDataReader)

Parameter

behavior
CommandBehavior

Instans CommandBehavior, menentukan opsi untuk eksekusi perintah dan pengambilan data.

cancellationToken
CancellationToken

Token untuk membatalkan operasi asinkron.

Mengembalikan

Tugas yang mewakili operasi asinkron.

Pengecualian

Terjadi kesalahan saat menjalankan perintah.

Nilai yang tidak valid CommandBehavior .

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

Keterangan

Untuk informasi selengkapnya tentang pemrograman asinkron, lihat Pemrograman Asinkron.

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

Berlaku untuk

Lihat juga