SqlDataReader.GetXmlReader(Int32) Metode

Definisi

Ruang nama:

System.Data.SqlClient

Rakitan:

System.Data.dll

Paket:

System.Data.SqlClient v4.8.6

Mengambil data jenis XML sebagai XmlReader.

public:
 virtual System::Xml::XmlReader ^ GetXmlReader(int i);

public virtual System.Xml.XmlReader GetXmlReader (int i);

abstract member GetXmlReader : int -> System.Xml.XmlReader
override this.GetXmlReader : int -> System.Xml.XmlReader

Public Overridable Function GetXmlReader (i As Integer) As XmlReader

Parameter

i

Int32

Nilai kolom yang ditentukan.

Mengembalikan

XmlReader

Objek yang dikembalikan.

Pengecualian

InvalidOperationException

Koneksi turun atau ditutup selama pengambilan data.

SqlDataReader ditutup selama pengambilan data.

Tidak ada data yang siap dibaca (misalnya, yang pertama Read() belum dipanggil, atau dikembalikan salah).

Mencoba membaca kolom yang dibaca sebelumnya dalam mode berurutan.

Ada operasi asinkron yang sedang berlangsung. Ini berlaku untuk semua metode Get* saat berjalan dalam mode berurutan, karena dapat dipanggil saat membaca aliran.

IndexOutOfRangeException

Mencoba membaca kolom yang tidak ada.

InvalidCastException

Jenis yang dikembalikan bukan xml.

Keterangan

Objek XmlReader yang dikembalikan oleh GetXmlReader tidak mendukung operasi asinkron. Jika Anda memerlukan operasi asinkron pada XmlReader, transmisikan kolom XML ke NVARCHAR(MAX) di server dan gunakan GetTextReader dengan Create.

SqlException pengecualian yang dimunculkan dari XmlReader dilemparkan sebagai XmlException pengecualian; periksa pengecualian dalam untuk SqlException.

GetChars akan menaikkan InvalidOperationException pengecualian ketika digunakan pada objek yang dikembalikan oleh GetXmlReader kapan SequentialAccess berlaku.

Untuk informasi selengkapnya, lihat Dukungan Streaming SqlClient.