XmlDocument.Load Metod

Definition

Namnområde:
System.Xml
Sammansättningar:
System.Xml.dll, System.Xml.XmlDocument.dll
Sammansättningar:
netstandard.dll, System.Xml.ReaderWriter.dll
Sammansättning:
System.Xml.XmlDocument.dll
Sammansättning:
System.Xml.ReaderWriter.dll
Sammansättning:
System.Xml.dll
Sammansättning:
netstandard.dll

Läser in angivna XML-data från en Stream, en URL, en TextReadereller en XmlReader.

Överlagringar

Name Description
Load(Stream)

Läser in XML-dokumentet från den angivna strömmen.
Load(TextReader)

Läser in XML-dokumentet från angivet TextReader.
Load(String)

Läser in XML-dokumentet från den angivna URL:en.
Load(XmlReader)

Läser in XML-dokumentet från angivet XmlReader.

Load(Stream)

Källa:
XmlDocument.cs
Källa:
XmlDocument.cs
Källa:
XmlDocument.cs
Källa:
XmlDocument.cs
Källa:
XmlDocument.cs

Läser in XML-dokumentet från den angivna strömmen.

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)

Parametrar

inStream
Stream

Strömmen som innehåller XML-dokumentet som ska läsas in.

Undantag

XmlException

Det finns ett belastnings- eller parsningsfel i XML-koden. I det här fallet väcks en FileNotFoundException .

Kommentarer

Note

Metoden Load bevarar alltid betydande blanksteg. Egenskapen PreserveWhitespace avgör om oansenlig blanksteg, dvs. tomt utrymme i elementinnehåll, bevaras. Standardvärdet är false; tomt utrymme i elementinnehåll bevaras inte.

Om du vill att verifieringen ska ske kan du skapa en verifierande XmlReader instans med hjälp XmlReaderSettings av klassen och Create metoden. Mer information finns i avsnittet Kommentarer på XmlReader referenssidan.

Den här metoden är ett Microsoft-tillägg till dokumentobjektmodellen (DOM).

Den här metoden identifierar automatiskt strängformatet för indata-XML (till exempel UTF-8, ANSI och så vidare). Om programmet behöver veta vilken kodning som används för att läsa dataströmmen bör du överväga att använda ett XmlTextReader objekt för att läsa dataströmmen och sedan använda XmlTextReader.Encoding egenskapen för att fastställa kodningen. Om du behöver använda ett XmlDocument objekt för att arbeta med XML kan du använda objektet XmlTextReader för att skapa ett. Mer information finns i Läsa XML-data med XPathDocument och XmlDocument.

Se även

Gäller för

Load(TextReader)

Källa:
XmlDocument.cs
Källa:
XmlDocument.cs
Källa:
XmlDocument.cs
Källa:
XmlDocument.cs
Källa:
XmlDocument.cs

Läser in XML-dokumentet från angivet 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)

Parametrar

txtReader
TextReader

Används TextReader för att mata in XML-data i dokumentet.

Undantag

XmlException

Det finns ett belastnings- eller parsningsfel i XML-koden. I det här fallet förblir dokumentet tomt.

Exempel

I följande exempel används StringReader klassen för att läsa in en sträng med XML-data i XmlDocument objektet.

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

Kommentarer

Note

Metoden Load bevarar alltid betydande blanksteg. Egenskapen PreserveWhitespace avgör om oansenlig blanksteg, dvs. tomt utrymme i elementinnehåll, bevaras. Standardvärdet är false; tomt utrymme i elementinnehåll bevaras inte.

Om du vill att verifieringen ska ske kan du skapa en verifierande XmlReader instans med hjälp XmlReaderSettings av klassen och Create metoden. Mer information finns i avsnittet Kommentarer på XmlReader referenssidan.

Den här metoden är ett Microsoft-tillägg till dokumentobjektmodellen (DOM).

Se även

Gäller för

Load(String)

Källa:
XmlDocument.cs
Källa:
XmlDocument.cs
Källa:
XmlDocument.cs
Källa:
XmlDocument.cs
Källa:
XmlDocument.cs

Läser in XML-dokumentet från den angivna URL:en.

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)

Parametrar

filename
String

URL för filen som innehåller XML-dokumentet som ska läsas in. URL:en kan vara antingen en lokal fil eller en HTTP-URL (en webbadress).

Undantag

XmlException

Det finns ett belastnings- eller parsningsfel i XML-koden. I det här fallet väcks en FileNotFoundException .

ArgumentException

filename är en sträng med noll längd, innehåller endast tomt utrymme eller innehåller ett eller flera ogiltiga tecken som definieras av InvalidPathChars.

ArgumentNullException

filename är null.

PathTooLongException

Den angivna sökvägen, filnamnet eller båda överskrider den systemdefinierade maximala längden.

DirectoryNotFoundException

Den angivna sökvägen är ogiltig (den finns till exempel på en ommappad enhet).

IOException

Ett I/O-fel uppstod när filen öppnades.

UnauthorizedAccessException

filename har angett en fil som är skrivskyddad.

-eller-

Den här åtgärden stöds inte på den aktuella plattformen.

-eller-

filename har angett en katalog.

-eller-

Anroparen har inte den behörighet som krävs.

FileNotFoundException

Filen som angavs i filename hittades inte.

NotSupportedException

filename är i ett ogiltigt format.

SecurityException

Anroparen har inte den behörighet som krävs.

Kommentarer

Note

Metoden Load bevarar alltid betydande blanksteg. Egenskapen PreserveWhitespace avgör om oansenlig blanksteg, dvs. tomt utrymme i elementinnehåll, bevaras. Standardvärdet är false; tomt utrymme i elementinnehåll bevaras inte.

Om du vill att verifieringen ska ske kan du skapa en verifierande XmlReader instans med hjälp XmlReaderSettings av klassen och Create metoden. Mer information finns i avsnittet Kommentarer på XmlReader referenssidan.

Den här metoden är ett Microsoft-tillägg till dokumentobjektmodellen (DOM).

Se även

Gäller för

Load(XmlReader)

Källa:
XmlDocument.cs
Källa:
XmlDocument.cs
Källa:
XmlDocument.cs
Källa:
XmlDocument.cs
Källa:
XmlDocument.cs

Läser in XML-dokumentet från angivet 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)

Parametrar

reader
XmlReader

Används XmlReader för att mata in XML-data i dokumentet.

Undantag

XmlException

Det finns ett belastnings- eller parsningsfel i XML-koden. I det här fallet förblir dokumentet tomt.

Exempel

I följande exempel läses den sista boknoden books.xml i filen in i XML-dokumentet.

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

I exemplet används filen , books.xmlsom indata.

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

Kommentarer

Note

Metoden Load bevarar alltid betydande blanksteg. Egenskapen PreserveWhitespace avgör om oansenlig blanksteg, dvs. tomt utrymme i elementinnehåll, bevaras. Standardvärdet är false; tomt utrymme i elementinnehåll bevaras inte.

Om läsaren är i det inledande tillståndet (ReadState =ReadState.Initial), Load förbrukar hela innehållet i läsaren och skapar DOM från vad den hittar.

Om läsaren redan är placerad på någon nod på djupet "n" läser den här metoden in noden och alla efterföljande syskon upp till sluttaggen som stänger djupet "n". Detta har följande resultat.

Om den aktuella noden och dess syskon ser ut så här:

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

Load genererar ett undantag eftersom ett dokument inte kan ha två rotnivåelement. Om den aktuella noden och dess syskon ser ut så här:

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

Load lyckas, men du har ett ofullständigt DOM-träd eftersom det inte finns något rotnivåelement. Innan du sparar dokumentet måste du lägga till ett element på rotnivå, annars Save genereras ett undantag.

Om läsaren är placerad på en lövnod som är ogiltig för rotnivån i ett dokument, till exempel ett tomt utrymme eller en attributnod, fortsätter läsaren att läsa tills den är placerad på en nod som kan användas för roten. Dokumentet börjar läsas in nu.

Om du vill att verifieringen ska ske kan du skapa en verifierande XmlReader instans med hjälp XmlReaderSettings av klassen och Create metoden. Mer information finns i avsnittet Kommentarer på XmlReader referenssidan.

Den här metoden är ett Microsoft-tillägg till dokumentobjektmodellen (DOM).

Se även

Gäller för