XmlDataDocument.Load Metode

Definisi

Ruang nama:

System.Xml

Rakitan:

System.Data.Common.dll

XmlDataDocument Memuat menggunakan sumber data yang ditentukan dan menyinkronkan dengan data yang DataSet dimuat.

Overload

Nama	Deskripsi
Load(Stream)	XmlDataDocument Memuat dari aliran yang ditentukan.
Load(TextReader)	XmlDataDocument Memuat dari TextReader.
Load(String)	XmlDataDocument Memuat menggunakan URL yang ditentukan.
Load(XmlReader)	XmlDataDocument Memuat dari XmlReader.

Keterangan

Nota

Untuk melihat data XML secara relasional, Anda harus terlebih dahulu menentukan skema yang akan digunakan untuk pemetaan data. Ini dapat dilakukan baik dengan memanggil ReadXmlSchema metode atau dengan membuat tabel dan kolom dalam DataSet secara manual. Langkah ini harus dilakukan sebelum memanggil Load.

XmlDataDocument tidak mendukung pembuatan referensi entitas. Jika data menyertakan referensi entitas, Load metode menyelesaikan dan memperluas referensi entitas apa pun. Namun, jika Anda menggunakan Load kelebihan beban yang mengambil XmlReader sebagai argumen, Anda harus menentukan XmlReader entitas yang dapat menyelesaikan entitas.

Load(Stream)

Sumber:

XmlDataDocument.cs

XmlDataDocument Memuat dari aliran yang ditentukan.

public:
 override void Load(System::IO::Stream ^ inStream);

public override void Load(System.IO.Stream inStream);

override this.Load : System.IO.Stream -> unit

Public Overrides Sub Load (inStream As Stream)

Parameter

inStream

Stream

Aliran yang berisi dokumen XML untuk dimuat.

Keterangan

XmlDataDocument tidak mendukung pembuatan referensi entitas. Jika data menyertakan referensi entitas, Load metode menyelesaikan dan memperluas referensi entitas apa pun.

Nota

Untuk melihat data XML secara relasional, Anda harus terlebih dahulu menentukan skema yang akan digunakan untuk pemetaan data. Ini dapat dilakukan baik dengan memanggil ReadXmlSchema metode atau dengan membuat tabel dan kolom dalam DataSet secara manual. Langkah ini harus dilakukan sebelum memanggil Load.

Load(TextReader)

Sumber:

XmlDataDocument.cs

XmlDataDocument Memuat dari TextReader.

public:
 override void Load(System::IO::TextReader ^ txtReader);

public override void Load(System.IO.TextReader txtReader);

override this.Load : System.IO.TextReader -> unit

Public Overrides Sub Load (txtReader As TextReader)

Parameter

txtReader

TextReader

yang TextReader digunakan untuk mengumpankan data XML ke dalam dokumen.

Keterangan

XmlDataDocument tidak mendukung pembuatan referensi entitas. Jika data menyertakan referensi entitas, Load metode menyelesaikan dan memperluas referensi entitas apa pun.

Nota

Untuk melihat data XML secara relasional, Anda harus terlebih dahulu menentukan skema yang akan digunakan untuk pemetaan data. Ini dapat dilakukan baik dengan memanggil ReadXmlSchema metode atau dengan membuat tabel dan kolom dalam DataSet secara manual. Langkah ini harus dilakukan sebelum memanggil Load.

Load(String)

Sumber:

XmlDataDocument.cs

XmlDataDocument Memuat menggunakan URL yang ditentukan.

public:
 override void Load(System::String ^ filename);

public override void Load(string filename);

override this.Load : string -> unit

Public Overrides Sub Load (filename As String)

Parameter

filename

String

URL file yang berisi dokumen XML untuk dimuat.

Keterangan

XmlDataDocument tidak mendukung pembuatan referensi entitas. Jika data menyertakan referensi entitas, Load metode menyelesaikan dan memperluas referensi entitas apa pun.

Nota

Untuk melihat data XML secara relasional, Anda harus terlebih dahulu menentukan skema yang akan digunakan untuk pemetaan data. Ini dapat dilakukan baik dengan memanggil ReadXmlSchema metode atau dengan membuat tabel dan kolom dalam DataSet secara manual. Langkah ini harus dilakukan sebelum memanggil Load.

Load(XmlReader)

Sumber:

XmlDataDocument.cs

XmlDataDocument Memuat dari XmlReader.

public:
 override void Load(System::Xml::XmlReader ^ reader);

public override void Load(System.Xml.XmlReader reader);

override this.Load : System.Xml.XmlReader -> unit

Public Overrides Sub Load (reader As XmlReader)

Parameter

reader

XmlReader

yang XmlReader berisi dokumen XML yang akan dimuat.

Pengecualian

NotSupportedException

XML yang dimuat berisi referensi entitas, dan pembaca tidak dapat menyelesaikan entitas.

Keterangan

XmlDataDocument tidak mendukung pembuatan referensi entitas. Jika sumber data berisi referensi entitas, Anda harus membuat dengan EntityHandling properti yang XmlValidatingReader diatur ke EntityHandling.ExpandEntities (ini adalah perilaku default) dan meneruskan XmlValidatingReader ke Load metode . Jika Anda tidak menggunakan XmlValidatingReader, Load metode melemparkan pengecualian.

Metode ini Load selalu mempertahankan ruang putih yang signifikan. Properti PreserveWhitespace menentukan apakah ruang kosong dipertahankan atau tidak. Defaultnya adalah false, spasi kosong tidak dipertahankan.

Jika pembaca dalam status awal (yaitu, ReadState=ReadState.Initial), Load mengonsumsi seluruh konten pembaca dan membangun DOM dari apa yang ditemukannya.

Jika pembaca sudah diposisikan pada beberapa node secara mendalam "n", maka metode ini memuat simpul tersebut dan semua saudara kandung berikutnya hingga tag akhir yang menutup kedalaman "n". Ini memiliki hasil berikut.

Jika simpul saat ini dan saudara-saudaranya berikut terlihat mirip dengan yang berikut ini:

<!--comment--><element1>one</element1><element2>two</element2>

Load melempar pengecualian, karena dokumen tidak boleh memiliki dua elemen tingkat akar. Jika simpul saat ini dan saudara-saudaranya berikut terlihat mirip dengan yang berikut ini:

<!--comment--><?process
    instruction?><!--comment--></endtag>

Load akan berhasil; namun, Anda akan memiliki pohon DOM yang tidak lengkap, karena tidak ada elemen tingkat akar. Anda harus menambahkan elemen tingkat akar sebelum menyimpan dokumen; jika tidak, metode melemparkan Save pengecualian.

Jika pembaca diposisikan pada simpul daun yang tidak valid untuk tingkat akar dokumen (misalnya, spasi kosong atau node atribut), pembaca terus membaca sampai diposisikan pada simpul yang sesuai untuk akar. Dokumen mulai dimuat pada saat ini.