SqlCommand.ExecuteReaderAsync Metode

Definisi

Ruang nama:: Microsoft.Data.SqlClient

Rakitan:: Microsoft.Data.SqlClient.dll

Paket:: Microsoft.Data.SqlClient v1.0.19269.1

Paket:: Microsoft.Data.SqlClient v1.1.4

Paket:: Microsoft.Data.SqlClient v2.0.1

Paket:: Microsoft.Data.SqlClient v2.1.4

Paket:: Microsoft.Data.SqlClient v3.0.1

Paket:: Microsoft.Data.SqlClient v3.1.0

Paket:: Microsoft.Data.SqlClient v4.0.1

Paket:: Microsoft.Data.SqlClient v4.1.0

Paket:: Microsoft.Data.SqlClient v5.0.0

Paket:: Microsoft.Data.SqlClient v5.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.1

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.

Overload

Nama	Deskripsi
ExecuteReaderAsync()	Versi asinkron dari ExecuteReader(), yang mengirim 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 mengirim 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 mengirim 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()

Sumber:: SqlCommand.cs

Sumber:: SqlCommand.cs

Sumber:: SqlCommand.cs

Sumber:: SqlCommand.cs

Versi asinkron dari ExecuteReader(), yang mengirim CommandText ke Connection dan membangun SqlDataReader. Pengecualian akan dilaporkan melalui objek Tugas yang dikembalikan.

public:
 System::Threading::Tasks::Task<Microsoft::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync();

public System.Threading.Tasks.Task<Microsoft.Data.SqlClient.SqlDataReader> ExecuteReaderAsync();

override this.ExecuteReaderAsync : unit -> System.Threading.Tasks.Task<Microsoft.Data.SqlClient.SqlDataReader>

Public Function ExecuteReaderAsync () As Task(Of SqlDataReader)

Mengembalikan

Task<SqlDataReader>

Tugas yang mewakili operasi asinkron.

Pengecualian

InvalidCastException

Selain SqlDbTypeBinary atau VarBinary digunakan ketika Value diatur ke Stream. Untuk informasi selengkapnya tentang streaming, lihat Dukungan Streaming SqlClient.
Selain SqlDbTypeChar, , NChar, NVarCharVarChar, atau Xml digunakan ketika Value diatur ke TextReader.
Selain SqlDbTypeXml digunakan ketika Value diatur ke XmlReader.

ArgumentException

Nilai yang tidak valid CommandBehavior .

InvalidOperationException

Memanggil ExecuteReaderAsync() lebih dari sekali untuk instans yang sama sebelum penyelesaian tugas.
Ditutup SqlConnection atau dihilangkan selama operasi streaming. Untuk informasi selengkapnya tentang streaming, lihat Dukungan Streaming SqlClient.

SqlException

SQL Server mengembalikan kesalahan saat menjalankan teks perintah.
Waktu habis terjadi selama operasi streaming. Untuk informasi selengkapnya tentang streaming, lihat Dukungan Streaming SqlClient.

IOException

Terjadi kesalahan dalam Streamobjek , XmlReader atau TextReader selama operasi streaming. Untuk informasi selengkapnya tentang streaming, lihat Dukungan Streaming SqlClient.

ObjectDisposedException

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 Data Provider .NET Framework untuk SQL Server, lihat Programan Asinkron.

Note

Untuk kueri yang berjalan lama di server, pertimbangkan untuk menggunakan ExecuteReader karena masalah yang diketahui dengan membatalkan kueri melalui token pembatalan. Selain itu, pertimbangkan untuk membatalkan eksekusi menggunakan metode .Cancel

Berlaku untuk

ExecuteReaderAsync(CommandBehavior)

Sumber:: SqlCommand.cs

Sumber:: SqlCommand.cs

Sumber:: SqlCommand.cs

Sumber:: SqlCommand.cs

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<Microsoft::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync(System::Data::CommandBehavior behavior);

public System.Threading.Tasks.Task<Microsoft.Data.SqlClient.SqlDataReader> ExecuteReaderAsync(System.Data.CommandBehavior behavior);

override this.ExecuteReaderAsync : System.Data.CommandBehavior -> System.Threading.Tasks.Task<Microsoft.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

Task<SqlDataReader>

Tugas yang mewakili operasi asinkron.

Pengecualian

InvalidCastException

Selain SqlDbTypeBinary atau VarBinary digunakan ketika Value diatur ke Stream. Untuk informasi selengkapnya tentang streaming, lihat Dukungan Streaming SqlClient.
Selain SqlDbTypeChar, , NChar, NVarCharVarChar, atau Xml digunakan ketika Value diatur ke TextReader.
Selain SqlDbTypeXml digunakan ketika Value diatur ke XmlReader.

ArgumentException

Nilai yang tidak valid CommandBehavior .

InvalidOperationException

Memanggil ExecuteReaderAsync(CommandBehavior) lebih dari sekali untuk instans yang sama sebelum penyelesaian tugas.
SqlConnection ditutup atau dihilangkan selama operasi streaming. Untuk informasi selengkapnya tentang streaming, lihat Dukungan Streaming SqlClient.

SqlException

SQL Server mengembalikan kesalahan saat menjalankan teks perintah.
Waktu habis terjadi selama operasi streaming. Untuk informasi selengkapnya tentang streaming, lihat Dukungan Streaming SqlClient.

IOException

Terjadi kesalahan dalam Streamobjek , XmlReader atau TextReader selama operasi streaming. Untuk informasi selengkapnya tentang streaming, lihat Dukungan Streaming SqlClient.

ObjectDisposedException

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 Data Provider .NET Framework untuk SQL Server, lihat Programan Asinkron.

Berlaku untuk

ExecuteReaderAsync(CancellationToken)

Sumber:: SqlCommand.cs

Sumber:: SqlCommand.cs

Sumber:: SqlCommand.cs

Sumber:: SqlCommand.cs

Versi asinkron dari ExecuteReader(), yang mengirim 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<Microsoft::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync(System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<Microsoft.Data.SqlClient.SqlDataReader> ExecuteReaderAsync(System.Threading.CancellationToken cancellationToken);

override this.ExecuteReaderAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Data.SqlClient.SqlDataReader>

Public Function ExecuteReaderAsync (cancellationToken As CancellationToken) As Task(Of SqlDataReader)

Parameter

cancellationToken: CancellationToken

Instruksi pembatalan.

Mengembalikan

Task<SqlDataReader>

Tugas yang mewakili operasi asinkron.

Pengecualian

InvalidCastException

Selain SqlDbTypeBinary atau VarBinary digunakan ketika Value diatur ke Stream. Untuk informasi selengkapnya tentang streaming, lihat Dukungan Streaming SqlClient.
Selain SqlDbTypeChar, , NChar, NVarCharVarChar, atau Xml digunakan ketika Value diatur ke TextReader.
Selain SqlDbTypeXml digunakan ketika Value diatur ke XmlReader.

ArgumentException

Nilai yang tidak valid CommandBehavior .

InvalidOperationException

Memanggil ExecuteReaderAsync(CommandBehavior, CancellationToken) lebih dari sekali untuk instans yang sama sebelum penyelesaian tugas.
Ditutup SqlConnection atau dihilangkan selama operasi streaming. Untuk informasi selengkapnya tentang streaming, lihat Dukungan Streaming SqlClient.

SqlException

SQL Server mengembalikan kesalahan saat menjalankan teks perintah.
Waktu habis terjadi selama operasi streaming. Untuk informasi selengkapnya tentang streaming, lihat Dukungan Streaming SqlClient.

IOException

Terjadi kesalahan dalam Streamobjek , XmlReader atau TextReader selama operasi streaming. Untuk informasi selengkapnya tentang streaming, lihat Dukungan Streaming SqlClient.

ObjectDisposedException

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 Data Provider .NET Framework untuk SQL Server, lihat Programan Asinkron.

Berlaku untuk

ExecuteReaderAsync(CommandBehavior, CancellationToken)

Sumber:: SqlCommand.cs

Sumber:: SqlCommand.cs

Sumber:: SqlCommand.cs

Sumber:: SqlCommand.cs

Versi asinkron dari ExecuteReader(CommandBehavior), yang mengirim 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<Microsoft::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync(System::Data::CommandBehavior behavior, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<Microsoft.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<Microsoft.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 yang lengkap.

cancellationToken: CancellationToken

Instruksi pembatalan.

Mengembalikan

Task<SqlDataReader>

Tugas yang mewakili operasi asinkron.

Pengecualian

InvalidCastException

Selain SqlDbTypeBinary atau VarBinary digunakan ketika Value diatur ke Stream. Untuk informasi selengkapnya tentang streaming, lihat Dukungan Streaming SqlClient.
Selain SqlDbTypeChar, , NChar, NVarCharVarChar, atau Xml digunakan ketika Value diatur ke TextReader.
Selain SqlDbTypeXml digunakan ketika Value diatur ke XmlReader.

ArgumentException

Nilai yang tidak valid CommandBehavior .

InvalidOperationException

Memanggil ExecuteReaderAsync(CommandBehavior, CancellationToken) lebih dari sekali untuk instans yang sama sebelum penyelesaian tugas.
Ditutup SqlConnection atau dihilangkan selama operasi streaming. Untuk informasi selengkapnya tentang streaming, lihat Dukungan Streaming SqlClient.

SqlException

SQL Server mengembalikan kesalahan saat menjalankan teks perintah.
Waktu habis terjadi selama operasi streaming. Untuk informasi selengkapnya tentang streaming, lihat Dukungan Streaming SqlClient.

IOException

Terjadi kesalahan dalam Streamobjek , XmlReader atau TextReader selama operasi streaming. Untuk informasi selengkapnya tentang streaming, lihat Dukungan Streaming SqlClient.

ObjectDisposedException

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 Data Provider .NET Framework untuk SQL Server, lihat Programan Asinkron.

Berlaku untuk