Bagikan melalui


SqlCommand.ExecuteXmlReaderAsync Metode

Definisi

Overload

ExecuteXmlReaderAsync()

Versi asinkron dari ExecuteXmlReader() , yang mengirim CommandText ke Connection dan membangun XmlReader objek.

Pengecualian akan dilaporkan melalui objek Tugas yang dikembalikan.

ExecuteXmlReaderAsync(CancellationToken)

Versi asinkron dari ExecuteXmlReader() , yang mengirim CommandText ke Connection dan membangun XmlReader objek.

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

ExecuteXmlReaderAsync()

Versi asinkron dari ExecuteXmlReader() , yang mengirim CommandText ke Connection dan membangun XmlReader objek.

Pengecualian akan dilaporkan melalui objek Tugas yang dikembalikan.

public:
 System::Threading::Tasks::Task<System::Xml::XmlReader ^> ^ ExecuteXmlReaderAsync();
public System.Threading.Tasks.Task<System.Xml.XmlReader> ExecuteXmlReaderAsync ();
member this.ExecuteXmlReaderAsync : unit -> System.Threading.Tasks.Task<System.Xml.XmlReader>
Public Function ExecuteXmlReaderAsync () As Task(Of XmlReader)

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 .

Memanggil ExecuteScalarAsync(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.

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 Stream objek , 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

XmlReader yang dikembalikan oleh metode ini tidak mendukung operasi asinkron. Untuk informasi selengkapnya tentang pemrograman asinkron di Penyedia Data .NET Framework untuk SQL Server, lihat Pemrograman Asinkron.

Catatan

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

Berlaku untuk

ExecuteXmlReaderAsync(CancellationToken)

Versi asinkron dari ExecuteXmlReader() , yang mengirim CommandText ke Connection dan membangun XmlReader objek.

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::Xml::XmlReader ^> ^ ExecuteXmlReaderAsync(System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task<System.Xml.XmlReader> ExecuteXmlReaderAsync (System.Threading.CancellationToken cancellationToken);
member this.ExecuteXmlReaderAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Xml.XmlReader>
Public Function ExecuteXmlReaderAsync (cancellationToken As CancellationToken) As Task(Of XmlReader)

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 .

Memanggil ExecuteScalarAsync(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.

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 Stream objek , 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

XmlReader yang dikembalikan oleh metode ini tidak mendukung operasi asinkron. Untuk informasi selengkapnya tentang pemrograman asinkron di Penyedia Data .NET Framework untuk SQL Server, lihat Pemrograman Asinkron.

Berlaku untuk