XmlDocument.Load Metódus

Definíció

Névtér:

System.Xml

Szerelvények:

netstandard.dll, System.Xml.ReaderWriter.dll

Betölti a megadott XML-adatokat egy Stream, URL-címből, egy TextReadervagy egy XmlReaderfájlból.

Túlterhelések

Name	Description
Load(Stream)	Betölti az XML-dokumentumot a megadott adatfolyamból.
Load(TextReader)	Betölti az XML-dokumentumot a megadottból TextReader.
Load(String)	Betölti az XML-dokumentumot a megadott URL-címről.
Load(XmlReader)	Betölti az XML-dokumentumot a megadottból XmlReader.

Load(Stream)

Forrás:

XmlDocument.cs

Betölti az XML-dokumentumot a megadott adatfolyamból.

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)

Paraméterek

inStream

Stream

A betöltendő XML-dokumentumot tartalmazó adatfolyam.

Kivételek

XmlException

Terhelési vagy elemzési hiba történt az XML-ben. Ebben az esetben egy FileNotFoundException elő van emelve.

Megjegyzések

Note

A Load módszer mindig megőrzi a jelentős szabad helyet. A PreserveWhitespace tulajdonság határozza meg, hogy megmarad-e a jelentéktelen fehér terület, azaz az elemtartalom fehér területe. Az alapértelmezett érték: falseaz elemtartalomban lévő üres terület nem marad meg.

Ha ellenőrzést szeretne végezni, létrehozhat egy érvényesítő XmlReader példányt az osztály és a XmlReaderSettingsCreate metódus használatával. További információt a referenciaoldal Megjegyzések szakaszában XmlReader talál.

Ez a metódus a Dokumentumobjektum-modell (DOM) Microsoft bővítménye.

Ez a metódus automatikusan észleli a bemeneti XML sztringformátumát (például UTF-8, ANSI stb.). Ha az alkalmazásnak tudnia kell, hogy melyik kódolást használja a stream olvasásához, fontolja meg egy XmlTextReader objektum használatát a stream olvasásához, majd használja a XmlTextReader.Encoding tulajdonságot a kódolás meghatározásához. Ha objektumot XmlDocument kell használnia az XML használatához, az XmlTextReader objektummal létrehozhat egyet. További információ: XML-adatok olvasása XPathDocument és XmlDocument használatával.

Lásd még

• ValidationEventArgs
• XmlSeverityType
• Schemas

Load(TextReader)

Forrás:

XmlDocument.cs

Betölti az XML-dokumentumot a megadottból 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)

Paraméterek

txtReader

TextReader

Az TextReader XML-adatok dokumentumba való betöltéséhez használt.

Kivételek

XmlException

Terhelési vagy elemzési hiba történt az XML-ben. Ebben az esetben a dokumentum üres marad.

Példák

Az alábbi példa az StringReader osztály használatával tölt be egy XML-adatokat tartalmazó sztringet az XmlDocument objektumba.

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

public class Sample1
{
  public static void CreateElementExample()
  {
    // Create the XmlDocument.
    XmlDocument doc = new();
    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

Megjegyzések

Note

A Load módszer mindig megőrzi a jelentős szabad helyet. A PreserveWhitespace tulajdonság határozza meg, hogy megmarad-e a jelentéktelen fehér terület, azaz az elemtartalom fehér területe. Az alapértelmezett érték: falseaz elemtartalomban lévő üres terület nem marad meg.

Ha ellenőrzést szeretne végezni, létrehozhat egy érvényesítő XmlReader példányt az osztály és a XmlReaderSettingsCreate metódus használatával. További információt a referenciaoldal Megjegyzések szakaszában XmlReader talál.

Ez a metódus a Dokumentumobjektum-modell (DOM) Microsoft bővítménye.

Lásd még

• StreamReader
• ValidationEventArgs
• XmlSeverityType
• Schemas

Load(String)

Forrás:

XmlDocument.cs

Betölti az XML-dokumentumot a megadott URL-címről.

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)

Paraméterek

filename

String

A betöltendő XML-dokumentumot tartalmazó fájl URL-címe. Az URL-cím lehet helyi fájl vagy HTTP URL-cím (webcím).

Kivételek

XmlException

Terhelési vagy elemzési hiba történt az XML-ben. Ebben az esetben egy FileNotFoundException elő van emelve.

ArgumentException

filename nulla hosszúságú sztring, csak üres szóközt tartalmaz, vagy egy vagy több érvénytelen karaktert tartalmaz a megadott módon InvalidPathChars.

ArgumentNullException

filename az null.

PathTooLongException

A megadott elérési út, fájlnév vagy mindkettő meghaladja a rendszer által megadott maximális hosszt.

DirectoryNotFoundException

A megadott elérési út érvénytelen (például egy nem leképezett meghajtón).

IOException

A fájl megnyitásakor I/O-hiba történt.

UnauthorizedAccessException

filename egy írásvédett fájlt adott meg.

-vagy-

Ez a művelet az aktuális platformon nem támogatott.

-vagy-

filename megadott egy könyvtárat.

-vagy-

A hívó nem rendelkezik a szükséges engedéllyel.

FileNotFoundException

A megadott filename fájl nem található.

NotSupportedException

filename formátuma érvénytelen.

SecurityException

A hívó nem rendelkezik a szükséges engedéllyel.

Megjegyzések

Note

A Load módszer mindig megőrzi a jelentős szabad helyet. A PreserveWhitespace tulajdonság határozza meg, hogy megmarad-e a jelentéktelen fehér terület, azaz az elemtartalom fehér területe. Az alapértelmezett érték: falseaz elemtartalomban lévő üres terület nem marad meg.

Ha ellenőrzést szeretne végezni, létrehozhat egy érvényesítő XmlReader példányt az osztály és a XmlReaderSettingsCreate metódus használatával. További információt a referenciaoldal Megjegyzések szakaszában XmlReader talál.

Ez a metódus a Dokumentumobjektum-modell (DOM) Microsoft bővítménye.

Lásd még

• ValidationEventArgs
• XmlSeverityType
• Schemas

Load(XmlReader)

Forrás:

XmlDocument.cs

Betölti az XML-dokumentumot a megadottból 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)

Paraméterek

reader

XmlReader

Az XmlReader XML-adatok dokumentumba való betöltéséhez használt.

Kivételek

XmlException

Terhelési vagy elemzési hiba történt az XML-ben. Ebben az esetben a dokumentum üres marad.

Példák

Az alábbi példa betölti a fájl utolsó könyvcsomópontját books.xml az XML-dokumentumba.

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

A példa a fájlt books.xmlhasználja bemenetként.

<?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>

Megjegyzések

Note

A Load módszer mindig megőrzi a jelentős szabad helyet. A PreserveWhitespace tulajdonság határozza meg, hogy megmarad-e a jelentéktelen fehér terület, azaz az elemtartalom fehér területe. Az alapértelmezett érték: falseaz elemtartalomban lévő üres terület nem marad meg.

Ha az olvasó kezdeti állapotban van (ReadState =ReadState.Initial), Load az olvasó teljes tartalmát felhasználja, és a dom-t a talált adatokból hozza létre.

Ha az olvasó már egy "n" mélységű csomóponton van elhelyezve, ez a módszer betölti a csomópontot és az összes további testvért az "n" mélységet lezáró végpontig. Ennek az alábbi eredményei vannak.

Ha az aktuális csomópont és testvérei a következőképpen néznek ki:

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

Load kivételt eredményez, mert egy dokumentumnak nem lehet két gyökérszintű eleme. Ha az aktuális csomópont és testvérei a következőképpen néznek ki:

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

Load sikeres, de hiányos DOM-fa van, mert nincs gyökérszintű elem. A dokumentum mentése előtt hozzá kell adnia egy gyökérszintű elemet, ellenkező esetben Save kivételt eredményez.

Ha az olvasó olyan levélcsomóponton van elhelyezve, amely érvénytelen a dokumentum gyökérszintjéhez, például egy üres területhez vagy attribútumcsomóponthoz, az olvasó addig olvassa az olvasót, amíg a gyökérhöz használható csomópontra nem kerül. A dokumentum ekkor kezd betöltődni.

Ha ellenőrzést szeretne végezni, létrehozhat egy érvényesítő XmlReader példányt az osztály és a XmlReaderSettingsCreate metódus használatával. További információt a referenciaoldal Megjegyzések szakaszában XmlReader talál.

Ez a metódus a Dokumentumobjektum-modell (DOM) Microsoft bővítménye.

Lásd még

• ValidationEventArgs
• XmlSeverityType
• Schemas