SqlDataReader.ReadAsync(CancellationToken) Metode

Definisi

Ruang nama:

System.Data.SqlClient

Rakitan:

System.Data.dll

Versi asinkron dari Read(), yang memajukan SqlDataReader ke rekaman berikutnya.

Token pembatalan dapat digunakan untuk meminta agar operasi ditinggalkan sebelum batas waktu perintah berlalu. Pengecualian akan dilaporkan melalui objek Tugas yang dikembalikan.

public:
 override System::Threading::Tasks::Task<bool> ^ ReadAsync(System::Threading::CancellationToken cancellationToken);

public override System.Threading.Tasks.Task<bool> ReadAsync (System.Threading.CancellationToken cancellationToken);

override this.ReadAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>

Public Overrides Function ReadAsync (cancellationToken As CancellationToken) As Task(Of Boolean)

Parameter

cancellationToken

CancellationToken

Instruksi pembatalan.

Mengembalikan

Task<Boolean>

Tugas yang mewakili operasi asinkron.

Pengecualian

InvalidOperationException

Memanggil ReadAsync(CancellationToken) lebih dari sekali untuk instans yang sama sebelum penyelesaian tugas.

Context Connection=trueditentukan dalam string koneksi.

SqlException

SQL Server mengembalikan kesalahan saat menjalankan teks perintah.

OperationCanceledException

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

Keterangan

behavior Jika parameter ExecuteReaderAsync diatur ke Default, ReadAsync membaca seluruh baris sebelum mengembalikan Tugas.

Untuk informasi selengkapnya, termasuk sampel kode, 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 Read().

Lihat juga

• Ringkasan ADO.NET