SqlCommand.ExecuteReaderAsync 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.
Memulai eksekusi asinkron dari pernyataan Transact-SQL atau prosedur tersimpan yang dijelaskan oleh ini SqlCommand.
Overload
| ExecuteReaderAsync() |
Versi asinkron dari ExecuteReader(), yang mengirimkan CommandText ke Connection dan membangun SqlDataReader. Pengecualian akan dilaporkan melalui objek Tugas yang dikembalikan. |
| ExecuteReaderAsync(CommandBehavior) |
Versi asinkron dari ExecuteReader(CommandBehavior), yang mengirimkan CommandText ke Connection, dan membangun SqlDataReader. Pengecualian akan dilaporkan melalui objek Tugas yang dikembalikan. |
| ExecuteReaderAsync(CancellationToken) |
Versi asinkron dari ExecuteReader(), yang mengirimkan CommandText ke Connection dan membangun SqlDataReader. Token pembatalan dapat digunakan untuk meminta agar operasi ditinggalkan sebelum batas waktu perintah berlalu. Pengecualian akan dilaporkan melalui objek Tugas yang dikembalikan. |
| ExecuteReaderAsync(CommandBehavior, CancellationToken) |
Versi asinkron dari ExecuteReader(CommandBehavior), yang mengirimkan CommandText ke Connection, dan membangun SqlDataReader Token pembatalan dapat digunakan untuk meminta agar operasi ditinggalkan sebelum batas waktu perintah berlalu. Pengecualian akan dilaporkan melalui objek Tugas yang dikembalikan. |
Keterangan
Untuk informasi selengkapnya tentang pemrograman asinkron di Penyedia Data .NET Framework untuk SQL Server, lihat Pemrograman Asinkron.
ExecuteReaderAsync()
Versi asinkron dari ExecuteReader(), yang mengirimkan CommandText ke Connection dan membangun SqlDataReader. Pengecualian akan dilaporkan melalui objek Tugas yang dikembalikan.
public:
System::Threading::Tasks::Task<System::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync();public System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader> ExecuteReaderAsync ();override this.ExecuteReaderAsync : unit -> System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader>Public Function ExecuteReaderAsync () As Task(Of SqlDataReader)Mengembalikan
Tugas yang mewakili operasi asinkron.
Pengecualian
Selain SqlDbTypeBiner atau VarBinary digunakan ketika Value diatur ke Stream. Untuk informasi selengkapnya tentang streaming, lihat Dukungan Streaming SqlClient.
-atau-
Selain SqlDbTypeChar, NChar, NVarChar, VarChar, atau Xml digunakan saat Value diatur ke TextReader.
-atau-
Selain SqlDbTypeXml digunakan ketika Value diatur ke XmlReader.
Nilai yang tidak valid CommandBehavior .
Memanggil ExecuteReaderAsync() lebih dari sekali untuk instans yang sama sebelum penyelesaian tugas.
-atau-
Ditutup SqlConnection atau dihilangkan selama operasi streaming. Untuk informasi selengkapnya tentang streaming, lihat Dukungan Streaming SqlClient.
-atau-
Context Connection=trueditentukan dalam string koneksi.
SQL Server mengembalikan kesalahan saat menjalankan teks perintah.
-atau-
Waktu habis terjadi selama operasi streaming. Untuk informasi selengkapnya tentang streaming, lihat Dukungan Streaming SqlClient.
Terjadi kesalahan dalam Streamobjek , XmlReader atau TextReader selama operasi streaming. Untuk informasi selengkapnya tentang streaming, lihat Dukungan Streaming SqlClient.
Objek Stream, XmlReader atau TextReader ditutup selama operasi streaming. Untuk informasi selengkapnya tentang streaming, lihat Dukungan Streaming SqlClient.
Keterangan
Untuk informasi selengkapnya 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 ExecuteReader().
Lihat juga
Berlaku untuk
ExecuteReaderAsync(CommandBehavior)
Versi asinkron dari ExecuteReader(CommandBehavior), yang mengirimkan CommandText ke Connection, dan membangun SqlDataReader. Pengecualian akan dilaporkan melalui objek Tugas yang dikembalikan.
public:
System::Threading::Tasks::Task<System::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync(System::Data::CommandBehavior behavior);public System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader> ExecuteReaderAsync (System.Data.CommandBehavior behavior);override this.ExecuteReaderAsync : System.Data.CommandBehavior -> System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader>Public Function ExecuteReaderAsync (behavior As CommandBehavior) As Task(Of SqlDataReader)Parameter
- behavior
- CommandBehavior
Opsi untuk eksekusi pernyataan dan pengambilan data. Ketika diatur ke Default, ReadAsync(CancellationToken) membaca seluruh baris sebelum mengembalikan Tugas yang lengkap.
Mengembalikan
Tugas yang mewakili operasi asinkron.
Pengecualian
Selain SqlDbTypeBiner atau VarBinary digunakan ketika Value diatur ke Stream. Untuk informasi selengkapnya tentang streaming, lihat Dukungan Streaming SqlClient.
-atau-
Selain SqlDbTypeChar, NChar, NVarChar, VarChar, atau Xml digunakan saat Value diatur ke TextReader.
-atau-
Selain SqlDbTypeXml digunakan ketika Value diatur ke XmlReader.
Nilai yang tidak valid CommandBehavior .
Memanggil ExecuteReaderAsync(CommandBehavior) lebih dari sekali untuk instans yang sama sebelum penyelesaian tugas.
-atau-
Ditutup SqlConnection atau dihilangkan selama operasi streaming. Untuk informasi selengkapnya tentang streaming, lihat Dukungan Streaming SqlClient.
-atau-
Context Connection=trueditentukan dalam string koneksi.
SQL Server mengembalikan kesalahan saat menjalankan teks perintah.
-atau-
Waktu habis terjadi selama operasi streaming. Untuk informasi selengkapnya tentang streaming, lihat Dukungan Streaming SqlClient.
Terjadi kesalahan dalam Streamobjek , XmlReader atau TextReader selama operasi streaming. Untuk informasi selengkapnya tentang streaming, lihat Dukungan Streaming SqlClient.
Objek Stream, XmlReader atau TextReader ditutup selama operasi streaming. Untuk informasi selengkapnya tentang streaming, lihat Dukungan Streaming SqlClient.
Keterangan
Untuk informasi selengkapnya 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 ExecuteReader(CommandBehavior).
Lihat juga
Berlaku untuk
ExecuteReaderAsync(CancellationToken)
Versi asinkron dari ExecuteReader(), yang mengirimkan CommandText ke Connection dan membangun SqlDataReader.
Token pembatalan dapat digunakan untuk meminta agar operasi ditinggalkan sebelum batas waktu perintah berlalu. Pengecualian akan dilaporkan melalui objek Tugas yang dikembalikan.
public:
System::Threading::Tasks::Task<System::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync(System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader> ExecuteReaderAsync (System.Threading.CancellationToken cancellationToken);override this.ExecuteReaderAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader>Public Function ExecuteReaderAsync (cancellationToken As CancellationToken) As Task(Of SqlDataReader)Parameter
- cancellationToken
- CancellationToken
Instruksi pembatalan.
Mengembalikan
Tugas yang mewakili operasi asinkron.
Pengecualian
Selain SqlDbTypeBiner atau VarBinary digunakan ketika Value diatur ke Stream. Untuk informasi selengkapnya tentang streaming, lihat Dukungan Streaming SqlClient.
-atau-
Selain SqlDbTypeChar, NChar, NVarChar, VarChar, atau Xml digunakan saat Value diatur ke TextReader.
-atau-
Selain SqlDbTypeXml digunakan ketika Value diatur ke XmlReader.
Nilai yang tidak valid CommandBehavior .
Memanggil ExecuteReaderAsync(CommandBehavior, CancellationToken) lebih dari sekali untuk instans yang sama sebelum penyelesaian tugas.
-atau-
Ditutup SqlConnection atau dihilangkan selama operasi streaming. Untuk informasi selengkapnya tentang streaming, lihat Dukungan Streaming SqlClient.
-atau-
Context Connection=trueditentukan dalam string koneksi.
SQL Server mengembalikan kesalahan saat menjalankan teks perintah.
-atau-
Waktu habis terjadi selama operasi streaming. Untuk informasi selengkapnya tentang streaming, lihat Dukungan Streaming SqlClient.
Terjadi kesalahan dalam Streamobjek , XmlReader atau TextReader selama operasi streaming. Untuk informasi selengkapnya tentang streaming, lihat Dukungan Streaming SqlClient.
Objek Stream, XmlReader atau TextReader ditutup selama operasi streaming. Untuk informasi selengkapnya tentang streaming, lihat Dukungan Streaming SqlClient.
Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.
Keterangan
Untuk informasi selengkapnya tentang pemrograman asinkron di Penyedia Data .NET Framework untuk SQL Server, 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 ExecuteReader().
Lihat juga
Berlaku untuk
ExecuteReaderAsync(CommandBehavior, CancellationToken)
Versi asinkron dari ExecuteReader(CommandBehavior), yang mengirimkan CommandText ke Connection, dan membangun SqlDataReader
Token pembatalan dapat digunakan untuk meminta agar operasi ditinggalkan sebelum batas waktu perintah berlalu. Pengecualian akan dilaporkan melalui objek Tugas yang dikembalikan.
public:
System::Threading::Tasks::Task<System::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync(System::Data::CommandBehavior behavior, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader> ExecuteReaderAsync (System.Data.CommandBehavior behavior, System.Threading.CancellationToken cancellationToken);override this.ExecuteReaderAsync : System.Data.CommandBehavior * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader>Public Function ExecuteReaderAsync (behavior As CommandBehavior, cancellationToken As CancellationToken) As Task(Of SqlDataReader)Parameter
- behavior
- CommandBehavior
Opsi untuk eksekusi pernyataan dan pengambilan data. Ketika diatur ke Default, ReadAsync(CancellationToken) membaca seluruh baris sebelum mengembalikan Tugas lengkap.
- cancellationToken
- CancellationToken
Instruksi pembatalan.
Mengembalikan
Tugas yang mewakili operasi asinkron.
Pengecualian
Selain SqlDbTypeBiner atau VarBinary digunakan ketika Value diatur ke Stream. Untuk informasi selengkapnya tentang streaming, lihat Dukungan Streaming SqlClient.
-atau-
Selain SqlDbTypeChar, NChar, NVarChar, VarChar, atau Xml digunakan saat Value diatur ke TextReader.
-atau-
Selain SqlDbTypeXml digunakan ketika Value diatur ke XmlReader.
Nilai yang tidak valid CommandBehavior .
Memanggil ExecuteReaderAsync(CommandBehavior, CancellationToken) lebih dari sekali untuk instans yang sama sebelum penyelesaian tugas.
-atau-
Ditutup SqlConnection atau dihilangkan selama operasi streaming. Untuk informasi selengkapnya tentang streaming, lihat Dukungan Streaming SqlClient.
-atau-
Context Connection=trueditentukan dalam string koneksi.
SQL Server mengembalikan kesalahan saat menjalankan teks perintah.
-atau-
Waktu habis terjadi selama operasi streaming. Untuk informasi selengkapnya tentang streaming, lihat Dukungan Streaming SqlClient.
Terjadi kesalahan dalam Streamobjek , XmlReader atau TextReader selama operasi streaming. Untuk informasi selengkapnya tentang streaming, lihat Dukungan Streaming SqlClient.
Objek Stream, XmlReader atau TextReader ditutup selama operasi streaming. Untuk informasi selengkapnya tentang streaming, lihat Dukungan Streaming SqlClient.
Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.
Keterangan
Untuk informasi selengkapnya tentang pemrograman asinkron di Penyedia Data .NET Framework untuk SQL Server, 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 ExecuteReader(CommandBehavior).
Lihat juga
Berlaku untuk
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk