SqlBatch.ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) Metode

Definisi

Ruang nama:: Microsoft.Data.SqlClient

Rakitan:: Microsoft.Data.SqlClient.dll

Paket:: Microsoft.Data.SqlClient v7.1.0

Paket:: Microsoft.Data.SqlClient v5.2.0

Paket:: Microsoft.Data.SqlClient v6.0.2

Paket:: Microsoft.Data.SqlClient v6.1.3

Paket:: Microsoft.Data.SqlClient v7.0.3

Sumber:: SqlBatch.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.

Implementasi ini memanggil ExecuteReaderAsync() metode dan mengembalikan tugas yang selesai. Implementasi default akan mengembalikan tugas yang dibatalkan jika melewati token pembatalan yang sudah dibatalkan. Metode ini menerima token pembatalan yang dapat digunakan untuk meminta operasi dibatalkan lebih awal.

protected:
 virtual System::Threading::Tasks::Task<System::Data::Common::DbDataReader ^> ^ ExecuteDbDataReaderAsync(System::Data::CommandBehavior behavior, System::Threading::CancellationToken cancellationToken);

protected:
 override 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);

protected override 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>

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)

Protected Overrides Function ExecuteDbDataReaderAsync (behavior As CommandBehavior, cancellationToken As CancellationToken) As Task(Of DbDataReader)

Parameter

behavior: CommandBehavior

Instans CommandBehavior, menentukan opsi untuk eksekusi batch dan pengambilan data. Hanya SequentialAccess dan CloseConnection didukung pada tingkat batch.

cancellationToken: CancellationToken

Token untuk membatalkan operasi asinkron.

Mengembalikan

Task<DbDataReader>

Tugas yang mewakili operasi asinkron.

Pengecualian

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

Note

Metode ini mendapat manfaat dari ExecuteReaderAsync(CancellationToken), dan semua pengecualian yang diharapkan dari metode itu juga berlaku di sini.

Berlaku untuk