Condividi tramite


XmlDocument.Load Metodo

Definizione

Carica i dati XML specificati da un Streamoggetto , un URL, un TextReaderoggetto o un oggetto XmlReader.

Overload

Nome Descrizione
Load(Stream)

Carica il documento XML dal flusso specificato.

Load(TextReader)

Carica il documento XML dall'oggetto specificato TextReader.

Load(String)

Carica il documento XML dall'URL specificato.

Load(XmlReader)

Carica il documento XML dall'oggetto specificato XmlReader.

Load(Stream)

Origine:
XmlDocument.cs
Origine:
XmlDocument.cs
Origine:
XmlDocument.cs
Origine:
XmlDocument.cs
Origine:
XmlDocument.cs

Carica il documento XML dal flusso specificato.

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)

Parametri

inStream
Stream

Flusso contenente il documento XML da caricare.

Eccezioni

Si è verificato un errore di caricamento o analisi nel codice XML. In questo caso, viene generato un oggetto FileNotFoundException .

Commenti

Annotazioni

Il Load metodo mantiene sempre spazi vuoti significativi. La PreserveWhitespace proprietà determina se lo spazio vuoto, ovvero lo spazio vuoto nel contenuto dell'elemento, viene mantenuto. Il valore predefinito è false; lo spazio vuoto nel contenuto dell'elemento non viene mantenuto.

Se si vuole eseguire la convalida, è possibile creare un'istanza di XmlReader convalida usando la XmlReaderSettings classe e il Create metodo . Per altre informazioni, vedere la sezione Note della pagina di riferimento XmlReader.

Questo metodo è un'estensione Microsoft al DOM (Document Object Model).

Questo metodo rileva automaticamente il formato stringa del codice XML di input, ad esempio UTF-8, ANSI e così via. Se l'applicazione deve conoscere la codifica usata per leggere il flusso, è consigliabile usare un XmlTextReader oggetto per leggere il flusso e quindi usare la XmlTextReader.Encoding proprietà per determinare la codifica. Se è necessario utilizzare un XmlDocument oggetto per lavorare con XML, è possibile usare l'oggetto XmlTextReader per crearne uno. Per altre informazioni, vedere Lettura di dati XML con XPathDocument e XmlDocument.

Vedi anche

Si applica a

Load(TextReader)

Origine:
XmlDocument.cs
Origine:
XmlDocument.cs
Origine:
XmlDocument.cs
Origine:
XmlDocument.cs
Origine:
XmlDocument.cs

Carica il documento XML dall'oggetto specificato 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)

Parametri

txtReader
TextReader

Oggetto TextReader utilizzato per inserire i dati XML nel documento.

Eccezioni

Si è verificato un errore di caricamento o analisi nel codice XML. In questo caso, il documento rimane vuoto.

Esempio

Nell'esempio seguente viene utilizzata la StringReader classe per caricare una stringa di dati XML nell'oggetto 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

Commenti

Annotazioni

Il Load metodo mantiene sempre spazi vuoti significativi. La PreserveWhitespace proprietà determina se lo spazio vuoto, ovvero lo spazio vuoto nel contenuto dell'elemento, viene mantenuto. Il valore predefinito è false; lo spazio vuoto nel contenuto dell'elemento non viene mantenuto.

Se si vuole eseguire la convalida, è possibile creare un'istanza di XmlReader convalida usando la XmlReaderSettings classe e il Create metodo . Per altre informazioni, vedere la sezione Note della pagina di riferimento XmlReader.

Questo metodo è un'estensione Microsoft al DOM (Document Object Model).

Vedi anche

Si applica a

Load(String)

Origine:
XmlDocument.cs
Origine:
XmlDocument.cs
Origine:
XmlDocument.cs
Origine:
XmlDocument.cs
Origine:
XmlDocument.cs

Carica il documento XML dall'URL specificato.

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)

Parametri

filename
String

URL del file contenente il documento XML da caricare. L'URL può essere un file locale o un URL HTTP (indirizzo Web).

Eccezioni

Si è verificato un errore di caricamento o analisi nel codice XML. In questo caso, viene generato un oggetto FileNotFoundException .

filename è una stringa di lunghezza zero, contiene solo spazi vuoti o contiene uno o più caratteri non validi, come definito da InvalidPathChars.

filename è null.

Il percorso, il nome file specificato o entrambi superano la lunghezza massima definita dal sistema.

Il percorso specificato non è valido( ad esempio, si trova in un'unità non mappata).

Si è verificato un errore di I/O durante l'apertura del file.

filename è stato specificato un file di sola lettura.

oppure

Questa operazione non è supportata nella piattaforma corrente.

oppure

filename è stata specificata una directory.

oppure

Il chiamante non dispone dell'autorizzazione richiesta.

Il file specificato in filename non è stato trovato.

filename è in un formato non valido.

Il chiamante non dispone dell'autorizzazione richiesta.

Commenti

Annotazioni

Il Load metodo mantiene sempre spazi vuoti significativi. La PreserveWhitespace proprietà determina se lo spazio vuoto, ovvero lo spazio vuoto nel contenuto dell'elemento, viene mantenuto. Il valore predefinito è false; lo spazio vuoto nel contenuto dell'elemento non viene mantenuto.

Se si vuole eseguire la convalida, è possibile creare un'istanza di XmlReader convalida usando la XmlReaderSettings classe e il Create metodo . Per altre informazioni, vedere la sezione Note della pagina di riferimento XmlReader.

Questo metodo è un'estensione Microsoft al DOM (Document Object Model).

Vedi anche

Si applica a

Load(XmlReader)

Origine:
XmlDocument.cs
Origine:
XmlDocument.cs
Origine:
XmlDocument.cs
Origine:
XmlDocument.cs
Origine:
XmlDocument.cs

Carica il documento XML dall'oggetto specificato 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)

Parametri

reader
XmlReader

Oggetto XmlReader utilizzato per inserire i dati XML nel documento.

Eccezioni

Si è verificato un errore di caricamento o analisi nel codice XML. In questo caso, il documento rimane vuoto.

Esempio

Nell'esempio seguente viene caricato l'ultimo nodo libro del books.xml file nel documento 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

Nell'esempio viene usato il file , books.xml, come input.

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

Commenti

Annotazioni

Il Load metodo mantiene sempre spazi vuoti significativi. La PreserveWhitespace proprietà determina se lo spazio vuoto, ovvero lo spazio vuoto nel contenuto dell'elemento, viene mantenuto. Il valore predefinito è false; lo spazio vuoto nel contenuto dell'elemento non viene mantenuto.

Se il lettore si trova nello stato iniziale (ReadState =ReadState.Initial), Load utilizza l'intero contenuto del lettore e compila il DOM da ciò che trova.

Se il lettore è già posizionato in un nodo alla profondità "n", questo metodo carica il nodo e tutti gli elementi di pari livello successivi fino al tag finale che chiude la profondità "n". I risultati sono i seguenti.

Se il nodo corrente e i relativi elementi di pari livello hanno un aspetto simile al seguente:

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

Load genera un'eccezione perché un documento non può avere due elementi di livello radice. Se il nodo corrente e i relativi elementi di pari livello hanno un aspetto simile al seguente:

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

Load ha esito positivo, ma si dispone di un albero DOM incompleto perché non esiste alcun elemento di livello radice. Prima di salvare il documento, è necessario aggiungere un elemento del livello radice. In caso contrario Save , verrà generata un'eccezione.

Se il lettore è posizionato in un nodo foglia non valido per il livello radice di un documento, ad esempio uno spazio vuoto o un nodo attributo, il lettore continua a leggere fino a quando non viene posizionato su un nodo che può essere usato per la radice. Il documento inizia il caricamento a questo punto.

Se si vuole eseguire la convalida, è possibile creare un'istanza di XmlReader convalida usando la XmlReaderSettings classe e il Create metodo . Per altre informazioni, vedere la sezione Note della pagina di riferimento XmlReader.

Questo metodo è un'estensione Microsoft al DOM (Document Object Model).

Vedi anche

Si applica a