Bagikan melalui

XmlDocument.Load Metode

  • Referensi

Definisi

Ruang nama:
System.Xml
Rakitan:
System.Xml.dll, System.Xml.XmlDocument.dll
Rakitan:
System.Xml.ReaderWriter.dll
Rakitan:
System.Xml.XmlDocument.dll
Rakitan:
System.Xml.dll
Rakitan:
netstandard.dll

Memuat data XML yang ditentukan dari Stream, URL, TextReader, atau XmlReader.

Overload

Load(Stream)

Memuat dokumen XML dari aliran yang ditentukan.
Load(TextReader)

Memuat dokumen XML dari yang ditentukan TextReader.
Load(String)

Memuat dokumen XML dari URL yang ditentukan.
Load(XmlReader)

Memuat dokumen XML dari yang ditentukan XmlReader.

Load(Stream)

Sumber:
XmlDocument.cs
Sumber:
XmlDocument.cs
Sumber:
XmlDocument.cs

Memuat dokumen XML dari aliran yang ditentukan.

public:
 virtual void Load(System::IO::Stream ^ inStream);
public virtual void Load (System.IO.Stream inStream);
abstract member Load : System.IO.Stream -> unit
override this.Load : System.IO.Stream -> unit
Public Overridable Sub Load (inStream As Stream)

Parameter

inStream
Stream

Aliran yang berisi dokumen XML untuk dimuat.

Pengecualian

XmlException

Ada kesalahan pemuatan atau penguraian dalam XML. Dalam hal ini, dinaikkan FileNotFoundException .

Keterangan

Catatan

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

Jika Anda ingin validasi terjadi, Anda dapat membuat instans validasi XmlReader dengan menggunakan XmlReaderSettings kelas dan Create metode . Untuk informasi selengkapnya, lihat bagian Keterangan dari halaman referensi XmlReader.

Metode ini adalah ekstensi Microsoft untuk Model Objek Dokumen (DOM).

Metode ini secara otomatis mendeteksi format string XML input (misalnya, UTF-8, ANSI, dan sebagainya). Jika aplikasi Anda perlu mengetahui pengodean mana yang digunakan untuk membaca aliran, pertimbangkan untuk menggunakan XmlTextReader objek untuk membaca aliran, lalu gunakan XmlTextReader.Encoding properti untuk menentukan pengodean. Jika Anda perlu menggunakan XmlDocument objek untuk bekerja dengan XML, Anda bisa menggunakan XmlTextReader objek untuk membuatnya. Untuk informasi selengkapnya, lihat Membaca Data XML menggunakan XPathDocument dan XmlDocument.

Lihat juga

Berlaku untuk

Load(TextReader)

Sumber:
XmlDocument.cs
Sumber:
XmlDocument.cs
Sumber:
XmlDocument.cs

Memuat dokumen XML dari yang ditentukan TextReader.

public:
 virtual void Load(System::IO::TextReader ^ txtReader);
public virtual void Load (System.IO.TextReader txtReader);
abstract member Load : System.IO.TextReader -> unit
override this.Load : System.IO.TextReader -> unit
Public Overridable Sub Load (txtReader As TextReader)

Parameter

txtReader
TextReader

yang TextReader digunakan untuk mengumpankan data XML ke dalam dokumen.

Pengecualian

XmlException

Ada kesalahan pemuatan atau penguraian dalam XML. Dalam hal ini, dokumen tetap kosong.

Contoh

Contoh berikut menggunakan StringReader kelas untuk memuat string data XML ke XmlDocument dalam objek .

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   
   // Create the XmlDocument.
   XmlDocument^ doc = gcnew XmlDocument;
   String^ xmlData = "<book xmlns:bk='urn:samples'></book>";
   doc->Load( gcnew StringReader( xmlData ) );
   
   // Create a new element and add it to the document.
   XmlElement^ elem = doc->CreateElement( "bk", "genre", "urn:samples" );
   elem->InnerText = "fantasy";
   doc->DocumentElement->AppendChild( elem );
   Console::WriteLine( "Display the modified XML..." );
   doc->Save( Console::Out );
}


using System;
using System.IO;
using System.Xml;

public class Sample {

  public static void Main() {

    // Create the XmlDocument.
    XmlDocument doc = new XmlDocument();
    string xmlData = "<book xmlns:bk='urn:samples'></book>";

    doc.Load(new StringReader(xmlData));

    // Create a new element and add it to the document.
    XmlElement elem = doc.CreateElement("bk", "genre", "urn:samples");
    elem.InnerText = "fantasy";
    doc.DocumentElement.AppendChild(elem);

    Console.WriteLine("Display the modified XML...");
    doc.Save(Console.Out);
  }
}

Imports System.IO
Imports System.Xml

public class Sample 

  public shared sub Main() 

    ' Create the XmlDocument.
    Dim doc as XmlDocument = new XmlDocument()
    Dim xmlData as string = "<book xmlns:bk='urn:samples'></book>"

    doc.Load(new StringReader(xmlData))

    ' Create a new element and add it to the document.
    Dim elem as XmlElement = doc.CreateElement("bk", "genre", "urn:samples")
    elem.InnerText = "fantasy"
    doc.DocumentElement.AppendChild(elem)

    Console.WriteLine("Display the modified XML...")
    doc.Save(Console.Out)

  end sub
end class

Keterangan

Catatan

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

Jika Anda ingin validasi terjadi, Anda dapat membuat instans validasi XmlReader dengan menggunakan XmlReaderSettings kelas dan Create metode . Untuk informasi selengkapnya, lihat bagian Keterangan dari halaman referensi XmlReader.

Metode ini adalah ekstensi Microsoft untuk Model Objek Dokumen (DOM).

Lihat juga

Berlaku untuk

Load(String)

Sumber:
XmlDocument.cs
Sumber:
XmlDocument.cs
Sumber:
XmlDocument.cs

Memuat dokumen XML dari URL yang ditentukan.

public:
 virtual void Load(System::String ^ filename);
public virtual void Load (string filename);
abstract member Load : string -> unit
override this.Load : string -> unit
Public Overridable Sub Load (filename As String)

Parameter

filename
String

URL untuk file yang berisi dokumen XML untuk dimuat. URL dapat berupa file lokal atau URL HTTP (alamat Web).

Pengecualian

XmlException

Ada kesalahan pemuatan atau penguraian dalam XML. Dalam hal ini, dinaikkan FileNotFoundException .

ArgumentException

filename adalah string panjang nol, hanya berisi spasi kosong, atau berisi satu atau beberapa karakter yang tidak valid seperti yang didefinisikan oleh InvalidPathChars.

ArgumentNullException

filenameadalah null.

PathTooLongException

Jalur yang ditentukan, nama file, atau keduanya melebihi panjang maksimum yang ditentukan sistem.

DirectoryNotFoundException

Jalur yang ditentukan tidak valid (misalnya, ada di drive yang tidak dipetakan).

IOException

Terjadi kesalahan I/O saat membuka file.

UnauthorizedAccessException

filename menentukan file yang bersifat baca-saja.

-atau-

Operasi ini tidak didukung pada platform saat ini.

-atau-

filename menentukan direktori.

-atau-

Pemanggil tidak memiliki izin yang diperlukan.

FileNotFoundException

File yang ditentukan di filename tidak ditemukan.

NotSupportedException

filename dalam format yang tidak valid.

SecurityException

Pemanggil tidak memiliki izin yang diperlukan.

Keterangan

Catatan

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

Jika Anda ingin validasi terjadi, Anda dapat membuat instans validasi XmlReader dengan menggunakan XmlReaderSettings kelas dan Create metode . Untuk informasi selengkapnya, lihat bagian Keterangan dari halaman referensi XmlReader.

Metode ini adalah ekstensi Microsoft untuk Model Objek Dokumen (DOM).

Lihat juga

Berlaku untuk

Load(XmlReader)

Sumber:
XmlDocument.cs
Sumber:
XmlDocument.cs
Sumber:
XmlDocument.cs

Memuat dokumen XML dari yang ditentukan XmlReader.

public:
 virtual void Load(System::Xml::XmlReader ^ reader);
public virtual void Load (System.Xml.XmlReader reader);
abstract member Load : System.Xml.XmlReader -> unit
override this.Load : System.Xml.XmlReader -> unit
Public Overridable Sub Load (reader As XmlReader)

Parameter

reader
XmlReader

yang XmlReader digunakan untuk mengumpankan data XML ke dalam dokumen.

Pengecualian

XmlException

Ada kesalahan pemuatan atau penguraian dalam XML. Dalam hal ini, dokumen tetap kosong.

Contoh

Contoh berikut memuat simpul books.xml buku terakhir file ke dalam dokumen XML.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   
   //Create the XmlDocument.
   XmlDocument^ doc = gcnew XmlDocument;
   
   //Load the document with the last book node.
   XmlTextReader^ reader = gcnew XmlTextReader( "books.xml" );
   reader->WhitespaceHandling = WhitespaceHandling::None;
   reader->MoveToContent();
   reader->Read();
   reader->Skip(); //Skip the first book.
   reader->Skip(); //Skip the second book.
   doc->Load( reader );
   doc->Save( Console::Out );
}


using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {
    //Create the XmlDocument.
    XmlDocument doc = new XmlDocument();

    //Load the document with the last book node.
    XmlTextReader reader = new XmlTextReader("books.xml");
    reader.WhitespaceHandling = WhitespaceHandling.None;
    reader.MoveToContent();
    reader.Read();
    reader.Skip(); //Skip the first book.
    reader.Skip(); //Skip the second book.
    doc.Load(reader);

    doc.Save(Console.Out);
  }
}

Option Explicit
Option Strict

Imports System.IO
Imports System.Xml

Public Class Sample
    
    Public Shared Sub Main()
        'Create the XmlDocument.
        Dim doc As New XmlDocument()
        
        'Load the document with the last book node.
        Dim reader As New XmlTextReader("books.xml")
        reader.WhitespaceHandling = WhitespaceHandling.None
        reader.MoveToContent()
        reader.Read()
        reader.Skip() 'Skip the first book.
        reader.Skip() 'Skip the second book.
        doc.Load(reader)
        
        doc.Save(Console.Out)
    End Sub
End Class

Contohnya menggunakan file , books.xml, sebagai input.

<?xml version='1.0'?>
<!-- This file represents a fragment of a book store inventory database -->
<bookstore>
  <book genre="autobiography" publicationdate="1981" ISBN="1-861003-11-0">
    <title>The Autobiography of Benjamin Franklin</title>
    <author>
      <first-name>Benjamin</first-name>
      <last-name>Franklin</last-name>
    </author>
    <price>8.99</price>
  </book>
  <book genre="novel" publicationdate="1967" ISBN="0-201-63361-2">
    <title>The Confidence Man</title>
    <author>
      <first-name>Herman</first-name>
      <last-name>Melville</last-name>
    </author>
    <price>11.99</price>
  </book>
  <book genre="philosophy" publicationdate="1991" ISBN="1-861001-57-6">
    <title>The Gorgias</title>
    <author>
      <name>Plato</name>
    </author>
    <price>9.99</price>
  </book>
</bookstore>

Keterangan

Catatan

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

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

Jika pembaca sudah diposisikan pada beberapa simpul secara mendalam "n", 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 terlihat seperti 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 terlihat seperti berikut ini:

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

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

Jika pembaca diposisikan pada simpul daun yang tidak valid untuk tingkat akar dokumen, misalnya spasi putih atau simpul atribut, pembaca terus membaca sampai diposisikan pada simpul yang dapat digunakan untuk root. Dokumen mulai dimuat pada saat ini.

Jika Anda ingin validasi terjadi, Anda dapat membuat instans validasi XmlReader dengan menggunakan XmlReaderSettings kelas dan Create metode . Untuk informasi selengkapnya, lihat bagian Keterangan dari halaman referensi XmlReader.

Metode ini adalah ekstensi Microsoft untuk Model Objek Dokumen (DOM).

Lihat juga

Berlaku untuk