DbCommand.ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) Metode

Referensi

Definisi

Ruang nama:: System.Data.Common

Rakitan:: System.Data.Common.dll

Rakitan:: System.Data.dll

Rakitan:: netstandard.dll

Sumber:: DbCommand.cs

Sumber:: DbCommand.cs

Sumber:: DbCommand.cs

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.

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

Task<DbDataReader>

Tugas yang mewakili operasi asinkron.

Pengecualian

DbException

Terjadi kesalahan saat menjalankan perintah.

ArgumentException

Nilai yang tidak valid CommandBehavior .

OperationCanceledException

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

Ringkasan ADO.NET