XmlDocument.Load Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

netstandard.dll, System.Xml.ReaderWriter.dll

Načte zadaná data XML z Streamadresy URL, a nebo TextReaderz XmlReader.

Přetížení

Name	Description
Load(Stream)	Načte dokument XML ze zadaného datového proudu.
Load(TextReader)	Načte dokument XML ze zadaného TextReadersouboru .
Load(String)	Načte dokument XML ze zadané adresy URL.
Load(XmlReader)	Načte dokument XML ze zadaného XmlReadersouboru .

Load(Stream)

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

XmlException

V souboru XML došlo k chybě načtení nebo parsování. V tomto případě je vyvolána.FileNotFoundException

Poznámky

Poznámka:

Metoda Load vždy zachovává významné prázdné znaky. Vlastnost PreserveWhitespace určuje, zda je nezanedbatelné prázdné znaky, které jsou prázdné znaky v obsahu prvku, zachovány. Výchozí hodnota je false– prázdné znaky v obsahu elementu se nezachovají.

Pokud chcete provést ověření, můžete vytvořit instanci ověřování XmlReader 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 Microsoftu pro model DOM (Document Object Model).

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í XmlTextReader objektu ke čtení datového proudu a pak pomocí XmlTextReader.Encoding vlastnosti určit 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 naleznete v tématu Čtení dat XML pomocí XPathDocument a XmlDocument.

Viz také

• ValidationEventArgs
• XmlSeverityType
• Schemas

Load(TextReader)

Zdroj:

XmlDocument.cs

Načte dokument XML ze zadaného TextReadersouboru .

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

XmlException

V souboru XML došlo k chybě načtení nebo parsování. 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;
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

Poznámky

Poznámka:

Metoda Load vždy zachovává významné prázdné znaky. Vlastnost PreserveWhitespace určuje, zda je nezanedbatelné prázdné znaky, které jsou prázdné znaky v obsahu prvku, zachovány. Výchozí hodnota je false– prázdné znaky v obsahu elementu se nezachovají.

Pokud chcete provést ověření, můžete vytvořit instanci ověřování XmlReader 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 Microsoftu pro model DOM (Document Object Model).

Viz také

• StreamReader
• ValidationEventArgs
• XmlSeverityType
• Schemas

Load(String)

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. Adresa URL může být místní soubor nebo adresa URL HTTP (webová adresa).

Výjimky

XmlException

V souboru XML došlo k chybě načtení nebo parsování. V tomto případě je vyvolána.FileNotFoundException

ArgumentException

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

ArgumentNullException

filename je null.

PathTooLongException

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

DirectoryNotFoundException

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

IOException

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

UnauthorizedAccessException

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

nebo

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

nebo

filename zadal adresář.

nebo

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

FileNotFoundException

Soubor zadaný v filename souboru nebyl nalezen.

NotSupportedException

filename je v neplatném formátu.

SecurityException

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 nezanedbatelné prázdné znaky, které jsou prázdné znaky v obsahu prvku, zachovány. Výchozí hodnota je false– prázdné znaky v obsahu elementu se nezachovají.

Pokud chcete provést ověření, můžete vytvořit instanci ověřování XmlReader 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 Microsoftu pro model DOM (Document Object Model).

Viz také

• ValidationEventArgs
• XmlSeverityType
• Schemas

Load(XmlReader)

Zdroj:

XmlDocument.cs

Načte dokument XML ze zadaného XmlReadersouboru .

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

XmlException

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

Příklady

Následující příklad načte poslední uzel books.xml knihy souboru do dokumentu XML.

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

Příklad používá soubor , books.xmljako vstup.

<?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 nezanedbatelné prázdné znaky, které jsou prázdné znaky v obsahu prvku, zachovány. 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 sestaví dom z toho, co najde.

Pokud je čtečka již umístěna na určitém uzlu v hloubkě "n", tato metoda načte tento uzel a všechny následné na stejné úrovni až do koncové značky, která zavř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 elementy kořenové úrovně. Pokud aktuální uzel a jeho na stejné úrovni vypadají takto:

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

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

Pokud je čtečka umístěna na uzlu typu list, který je neplatný pro kořenovou úroveň dokumentu, například prázdný znak nebo uzel atributu, bude čtenář dál číst, dokud nebude umístěn na uzlu, který lze použít pro kořen. Dokument se v tomto okamžiku začne načítat.

Pokud chcete provést ověření, můžete vytvořit instanci ověřování XmlReader 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 Microsoftu pro model DOM (Document Object Model).

Viz také

• ValidationEventArgs
• XmlSeverityType
• Schemas