SqlDataReader.ReadAsync(CancellationToken) Metode
Definisi
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.
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
Tugas yang mewakili operasi asinkron.
Pengecualian
Memanggil ReadAsync(CancellationToken) lebih dari sekali untuk instans yang sama sebelum penyelesaian tugas.
SQL Server mengembalikan kesalahan saat menjalankan teks perintah.
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.
Catatan
Saat membaca data besar (biner/teks), disarankan untuk digunakan Read untuk performa optimal.