XmlDocument.Load Metoda

Definice

Načte zadaná data XML z objektu Stream, adresy URL, objektu XmlReaderTextReadernebo .

Přetížení

Load(Stream)

Načte dokument XML ze zadaného datového proudu.

Load(TextReader)

Načte dokument XML ze zadaného TextReaderobjektu .

Load(String)

Načte dokument XML ze zadané adresy URL.

Load(XmlReader)

Načte dokument XML ze zadaného XmlReaderobjektu .

Load(Stream)

Zdroj:
XmlDocument.cs
Zdroj:
XmlDocument.cs
Zdroj:
XmlDocument.cs

Načte dokument XML ze zadaného datového proudu.

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)

Parametry

inStream
Stream

Datový proud obsahující dokument XML, který se má načíst.

Výjimky

V souboru XML došlo k chybě načtení nebo analýzy. V tomto případě je vyvolána hodnota FileNotFoundException .

Poznámky

Poznámka

Metoda Load vždy zachovává významné prázdné znaky. Vlastnost PreserveWhitespace určuje, zda je zachována nevýznamná mezera, tj. prázdné místo v obsahu prvku. Výchozí hodnota je false; prázdné znaky v obsahu elementu se nezachovají.

Pokud chcete provést ověření, můžete vytvořit ověřovací XmlReader instanci pomocí XmlReaderSettings třídy a Create metody . Další informace najdete v části Poznámky na XmlReader referenční stránce.

Tato metoda je rozšířením modelu DOM (Document Object Model) od Microsoftu.

Tato metoda automaticky rozpozná formát řetězce vstupního XML (například UTF-8, ANSI atd.). Pokud vaše aplikace potřebuje vědět, které kódování se používá ke čtení datového proudu, zvažte použití objektu XmlTextReader ke čtení datového proudu a pak pomocí XmlTextReader.Encoding vlastnosti určete kódování. Pokud potřebujete použít XmlDocument objekt pro práci s XML, můžete ho XmlTextReader použít k jeho vytvoření. Další informace najdete v tématu Čtení dat XML pomocí XPathDocument a XmlDocument.

Viz také

Platí pro

Load(TextReader)

Zdroj:
XmlDocument.cs
Zdroj:
XmlDocument.cs
Zdroj:
XmlDocument.cs

Načte dokument XML ze zadaného TextReaderobjektu .

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)

Parametry

txtReader
TextReader

Slouží TextReader k podávání dat XML do dokumentu.

Výjimky

V souboru XML došlo k chybě načtení nebo analýzy. V tomto případě zůstane dokument prázdný.

Příklady

Následující příklad používá StringReader třídu k načtení řetězce dat XML do objektu XmlDocument .

#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

Poznámky

Poznámka

Metoda Load vždy zachovává významné prázdné znaky. Vlastnost PreserveWhitespace určuje, zda je zachována nevýznamná mezera, tj. prázdné místo v obsahu prvku. Výchozí hodnota je false; prázdné znaky v obsahu elementu se nezachovají.

Pokud chcete provést ověření, můžete vytvořit ověřovací XmlReader instanci pomocí XmlReaderSettings třídy a Create metody . Další informace najdete v části Poznámky na XmlReader referenční stránce.

Tato metoda je rozšířením modelu DOM (Document Object Model) od Microsoftu.

Viz také

Platí pro

Load(String)

Zdroj:
XmlDocument.cs
Zdroj:
XmlDocument.cs
Zdroj:
XmlDocument.cs

Načte dokument XML ze zadané adresy URL.

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)

Parametry

filename
String

Adresa URL souboru obsahujícího dokument XML, který se má načíst. Adresou URL může být místní soubor nebo adresa URL protokolu HTTP (webová adresa).

Výjimky

V souboru XML došlo k chybě načtení nebo analýzy. V tomto případě je vyvolána hodnota FileNotFoundException .

filename je řetězec nulové délky, obsahuje pouze prázdné znaky nebo obsahuje jeden nebo více neplatných znaků definovaných nástrojem InvalidPathChars.

filename je null.

Zadaná cesta, název souboru nebo obojí překračují maximální délku definovanou systémem.

Zadaná cesta je neplatná (například je na nenamapované jednotce).

Při otevírání souboru došlo ke vstupně-výstupní chybě.

filename zadal(a) soubor, který je jen pro čtení.

-nebo-

Tato operace není na aktuální platformě podporovaná.

-nebo-

filename zadal(a) adresář.

-nebo-

Volající nemá požadované oprávnění.

Soubor zadaný v filename souboru nebyl nalezen.

filename je v neplatném formátu.

Volající nemá požadované oprávnění.

Poznámky

Poznámka

Metoda Load vždy zachovává významné prázdné znaky. Vlastnost PreserveWhitespace určuje, zda je zachována nevýznamná mezera, tj. prázdné místo v obsahu prvku. Výchozí hodnota je false; prázdné znaky v obsahu elementu se nezachovají.

Pokud chcete provést ověření, můžete vytvořit ověřovací XmlReader instanci pomocí XmlReaderSettings třídy a Create metody . Další informace najdete v části Poznámky na XmlReader referenční stránce.

Tato metoda je rozšířením modelu DOM (Document Object Model) od Microsoftu.

Viz také

Platí pro

Load(XmlReader)

Zdroj:
XmlDocument.cs
Zdroj:
XmlDocument.cs
Zdroj:
XmlDocument.cs

Načte dokument XML ze zadaného XmlReaderobjektu .

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)

Parametry

reader
XmlReader

Slouží XmlReader k podávání dat XML do dokumentu.

Výjimky

V souboru XML došlo k chybě načtení nebo analýzy. V tomto případě zůstane dokument prázdný.

Příklady

Následující příklad načte poslední sešit uzlu books.xml souboru do dokumentu 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

V příkladu se jako vstup používá soubor books.xml, .

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

Poznámky

Poznámka

Metoda Load vždy zachovává významné prázdné znaky. Vlastnost PreserveWhitespace určuje, zda je zachována nevýznamná mezera, tj. prázdné místo v obsahu prvku. Výchozí hodnota je false; prázdné znaky v obsahu elementu se nezachovají.

Pokud je čtenář v počátečním stavu (ReadState =ReadState.Initial), Load spotřebovává celý obsah čtečky a z nalezených dat sestaví dom.

Pokud je čtenář již umístěn na některém uzlu v hloubce "n", tato metoda načte tento uzel a všechny další na stejné úrovni až do koncové značky, která uzavře hloubku "n". To má následující výsledky.

Pokud aktuální uzel a jeho na stejné úrovni vypadají takto:

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

Load vyvolá výjimku, protože dokument nemůže mít dva prvky kořenové úrovně. Pokud aktuální uzel a jeho na stejné úrovni vypadají takto:

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

Load je úspěšný, ale máte neúplný strom dom, protože neexistuje žádný element kořenové úrovně. Před uložením dokumentu je nutné přidat prvek kořenové úrovně, jinak Save dojde k výjimce.

Pokud je čtenář umístěn na uzlu typu list, který není platný pro kořenovou úroveň dokumentu, například prázdné znaky nebo uzel atributu, bude čtenář pokračovat ve čtení, dokud není umístěn na uzlu, který lze použít pro kořen. Dokument se začne načítat v tomto okamžiku.

Pokud chcete provést ověření, můžete vytvořit ověřovací XmlReader instanci pomocí XmlReaderSettings třídy a Create metody . Další informace najdete v části Poznámky na XmlReader referenční stránce.

Tato metoda je rozšířením modelu DOM (Document Object Model) od Microsoftu.

Viz také

Platí pro