XmlDocument.Load Metoda

Definicja

Przestrzeń nazw:

System.Xml

Zestaw:

System.Xml.ReaderWriter.dll

Ładuje określone dane XML z Streamadresu URL, lub TextReader.XmlReader

Przeciążenia

Load(Stream)	Ładuje dokument XML z określonego strumienia.
Load(TextReader)	Ładuje dokument XML z określonego TextReaderelementu .
Load(String)	Ładuje dokument XML z określonego adresu URL.
Load(XmlReader)	Ładuje dokument XML z określonego XmlReaderelementu .

Load(Stream)

Źródło:

XmlDocument.cs

Ładuje dokument XML z określonego strumienia.

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

Strumień zawierający dokument XML do załadowania.

Wyjątki

XmlException

W pliku XML występuje błąd ładowania lub analizowania. W tym przypadku zostanie podniesiona wartość FileNotFoundException .

Uwagi

Uwaga

Metoda Load zawsze zachowuje znaczną ilość białych znaków. Właściwość PreserveWhitespace określa, czy odstęp nieistotny, czyli biały odstęp w zawartości elementu, jest zachowywany. Wartość domyślna to false; odstęp w zawartości elementu nie jest zachowywany.

Jeśli chcesz przeprowadzić walidację, możesz utworzyć wystąpienie weryfikacji XmlReader przy użyciu XmlReaderSettings klasy i Create metody . Aby uzyskać więcej informacji, zobacz sekcję Uwagi na stronie referencyjnej XmlReader .

Ta metoda jest rozszerzeniem firmy Microsoft do modelu obiektów dokumentów (DOM).

Ta metoda automatycznie wykrywa format ciągu wejściowego kodu XML (na przykład UTF-8, ANSI itd.). Jeśli aplikacja musi wiedzieć, które kodowanie jest używane do odczytywania strumienia, rozważ użycie XmlTextReader obiektu do odczytania strumienia, a następnie użycie XmlTextReader.Encoding właściwości w celu określenia kodowania. Jeśli musisz użyć XmlDocument obiektu do pracy z kodem XML, możesz go utworzyć za pomocą XmlTextReader obiektu . Aby uzyskać więcej informacji, zobacz Odczytywanie danych XML przy użyciu narzędzi XPathDocument i XmlDocument.

Zobacz też

• ValidationEventArgs
• XmlSeverityType
• Schemas

Load(TextReader)

Źródło:

XmlDocument.cs

Ładuje dokument XML z określonego TextReaderelementu .

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

Dane TextReader używane do podawania danych XML do dokumentu.

Wyjątki

XmlException

W pliku XML występuje błąd ładowania lub analizowania. W takim przypadku dokument pozostaje pusty.

Przykłady

W poniższym przykładzie użyto StringReader klasy do załadowania ciągu danych XML do XmlDocument obiektu.

#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

Uwagi

Uwaga

Metoda Load zawsze zachowuje znaczną ilość białych znaków. Właściwość PreserveWhitespace określa, czy odstęp nieistotny, czyli biały odstęp w zawartości elementu, jest zachowywany. Wartość domyślna to false; odstęp w zawartości elementu nie jest zachowywany.

Jeśli chcesz przeprowadzić walidację, możesz utworzyć wystąpienie weryfikacji XmlReader przy użyciu XmlReaderSettings klasy i Create metody . Aby uzyskać więcej informacji, zobacz sekcję Uwagi na stronie referencyjnej XmlReader .

Ta metoda jest rozszerzeniem firmy Microsoft do modelu obiektów dokumentów (DOM).

Zobacz też

• StreamReader
• ValidationEventArgs
• XmlSeverityType
• Schemas

Load(String)

Źródło:

XmlDocument.cs

Ładuje dokument XML z określonego adresu 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

Adres URL pliku zawierającego dokument XML do załadowania. Adres URL może być plikiem lokalnym lub adresem URL HTTP (adresem internetowym).

Wyjątki

XmlException

W pliku XML występuje błąd ładowania lub analizowania. W tym przypadku zostanie podniesiona wartość FileNotFoundException .

ArgumentException

filename jest ciągiem o zerowej długości, zawiera tylko białe znaki lub zawiera co najmniej jeden nieprawidłowy znak zdefiniowany przez InvalidPathCharsmetodę .

ArgumentNullException

filename to null.

PathTooLongException

Podana ścieżka, nazwa pliku lub obie przekraczają maksymalną długość zdefiniowaną przez system.

DirectoryNotFoundException

Określona ścieżka jest nieprawidłowa (na przykład znajduje się na niezamapowanym dysku).

IOException

Podczas otwierania pliku wystąpił błąd We/Wy.

UnauthorizedAccessException

filename określono plik, który jest tylko do odczytu.

-lub-

Ta operacja nie jest obsługiwana na bieżącej platformie.

-lub-

filename określony katalog.

-lub-

Obiekt wywołujący nie posiada wymaganych uprawnień.

FileNotFoundException

Nie można odnaleźć pliku określonego w filename pliku.

NotSupportedException

filename jest w nieprawidłowym formacie.

SecurityException

Obiekt wywołujący nie posiada wymaganych uprawnień.

Uwagi

Uwaga

Metoda Load zawsze zachowuje znaczną ilość białych znaków. Właściwość PreserveWhitespace określa, czy odstęp nieistotny, czyli biały odstęp w zawartości elementu, jest zachowywany. Wartość domyślna to false; odstęp w zawartości elementu nie jest zachowywany.

Jeśli chcesz przeprowadzić walidację, możesz utworzyć wystąpienie weryfikacji XmlReader przy użyciu XmlReaderSettings klasy i Create metody . Aby uzyskać więcej informacji, zobacz sekcję Uwagi na stronie referencyjnej XmlReader .

Ta metoda jest rozszerzeniem firmy Microsoft do modelu obiektów dokumentów (DOM).

Zobacz też

• ValidationEventArgs
• XmlSeverityType
• Schemas

Load(XmlReader)

Źródło:

XmlDocument.cs

Ładuje dokument XML z określonego XmlReaderelementu .

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

Dane XmlReader używane do podawania danych XML do dokumentu.

Wyjątki

XmlException

W pliku XML występuje błąd ładowania lub analizowania. W takim przypadku dokument pozostaje pusty.

Przykłady

Poniższy przykład ładuje ostatni węzeł books.xml książki pliku 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

W przykładzie użyto pliku , books.xmljako danych wejściowych.

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

Uwagi

Uwaga

Metoda Load zawsze zachowuje znaczną ilość białych znaków. Właściwość PreserveWhitespace określa, czy odstęp nieistotny, czyli biały odstęp w zawartości elementu, jest zachowywany. Wartość domyślna to false; odstęp w zawartości elementu nie jest zachowywany.

Jeśli czytnik jest w stanie początkowym (ReadState =ReadState.Initial), Load zużywa całą zawartość czytnika i tworzy dom z tego, co znajduje.

Jeśli czytnik jest już umieszczony w węźle o głębokości "n", ta metoda ładuje ten węzeł i wszystkie kolejne elementy równorzędne do tagu końcowego zamykające głębokość "n". Ma to następujące wyniki.

Jeśli bieżący węzeł i jego elementy równorzędne wyglądają następująco:

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

Load zgłasza wyjątek, ponieważ dokument nie może mieć dwóch elementów poziomu głównego. Jeśli bieżący węzeł i jego elementy równorzędne wyglądają następująco:

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

Load kończy się powodzeniem, ale masz niekompletne drzewo DOM, ponieważ nie ma elementu poziomu głównego. Przed zapisaniem dokumentu należy dodać element poziomu głównego, w przeciwnym razie Save zgłosi wyjątek.

Jeśli czytnik jest umieszczony w węźle liścia, który jest nieprawidłowy dla poziomu głównego dokumentu, na przykład biały odstęp lub węzeł atrybutu, czytnik będzie nadal odczytywać, dopóki nie zostanie umieszczony w węźle, który może być używany dla katalogu głównego. Dokument rozpoczyna ładowanie w tym momencie.

Jeśli chcesz przeprowadzić walidację, możesz utworzyć wystąpienie weryfikacji XmlReader przy użyciu XmlReaderSettings klasy i Create metody . Aby uzyskać więcej informacji, zobacz sekcję Uwagi na stronie referencyjnej XmlReader .

Ta metoda jest rozszerzeniem firmy Microsoft do modelu obiektów dokumentów (DOM).

Zobacz też

• ValidationEventArgs
• XmlSeverityType
• Schemas