XmlDocument.Load Metodo

Definizione

Carica i dati XML specificati da un oggetto Stream, un URL, un oggetto TextReader o un oggetto XmlReader.

Overload

Load(Stream)

Carica il documento XML dal flusso specificato.

Load(TextReader)

Carica il documento XML dall'oggetto TextReader specificato.

Load(String)

Carica il documento XML dall'URL specificato.

Load(XmlReader)

Carica il documento XML dall'oggetto XmlReader specificato.

Load(Stream)

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 che contiene il documento XML da caricare.

Eccezioni

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

Commenti

Nota

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

Se si vuole che venga eseguita la convalida, è possibile creare un'istanza di convalida XmlReader 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 per il modello a oggetti document (DOM).

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 quale codifica viene usata per leggere il flusso, prendere in considerazione l'uso di un XmlTextReader oggetto per leggere il flusso e quindi usare la XmlTextReader.Encoding proprietà per determinare la codifica. Se è necessario usare un XmlDocument oggetto per usare XML, è possibile usare l'oggetto XmlTextReader per crearne uno. Per altre informazioni, vedere Lettura di dati XML tramite XPathDocument e XmlDocument.

Vedi anche

Si applica a

Load(TextReader)

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

Carica il documento XML dall'oggetto TextReader specificato.

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 usato per inserire i dati XML nel documento.

Eccezioni

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

Esempio

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

Commenti

Nota

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

Se si vuole che venga eseguita la convalida, è possibile creare un'istanza di convalida XmlReader 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 per il modello a oggetti document (DOM).

Vedi anche

Si applica a

Load(String)

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 che contiene il documento XML da caricare. L'URL può essere un file locale o un URL HTTP, ovvero un indirizzo Web.

Eccezioni

Si è verificato un errore di analisi o di caricamento 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 definiti da InvalidPathChars.

filename è null.

Il percorso specificato, il nome file 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 specifica un file di sola lettura.

-oppure-

L'operazione non è supportata sulla piattaforma corrente.

-oppure-

filename ha specificato una directory.

-oppure-

Il chiamante non dispone dell'autorizzazione richiesta.

Il file specificato in filename non è stato trovato.

Il formato di filename non è valido.

Il chiamante non dispone dell'autorizzazione richiesta.

Commenti

Nota

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

Se si vuole che venga eseguita la convalida, è possibile creare un'istanza di convalida XmlReader 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 per il modello a oggetti document (DOM).

Vedi anche

Si applica a

Load(XmlReader)

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

Carica il documento XML dall'oggetto XmlReader specificato.

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 usato per inserire i dati XML nel documento.

Eccezioni

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

Esempio

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

Nell'esempio viene usato il file, , books.xmlcome 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

Nota

Il Load metodo mantiene sempre uno spazio vuoto significativo. La proprietà determina se lo spazio vuoto, ovvero lo spazio vuoto nel contenuto dell'elemento PreserveWhitespace , 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 usa l'intero contenuto del lettore e compila il DOM da ciò che trova.

Se il lettore è già posizionato in un nodo a profondità "n", questo metodo carica il nodo e tutti i fratelli successivi fino al tag finale che chiude la profondità "n". Questo ha i risultati seguenti.

Se il nodo corrente e i relativi fratelli sono simili al seguente:

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

Load genera un'eccezione perché un documento non può avere due elementi a livello radice. Se il nodo corrente e i relativi fratelli sono simili al seguente:

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

Load ha esito positivo, ma si dispone di un albero DOM incompleto perché non esiste alcun elemento a livello radice. Prima di salvare il documento, è necessario aggiungere un elemento a livello radice, altrimenti Save genererà un'eccezione.

Se il lettore è posizionato su 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 finché non viene posizionato su un nodo che può essere usato per la radice. Il caricamento del documento avverrà a partire da questo punto.

Se si vuole che venga eseguita la convalida, è possibile creare un'istanza di convalida XmlReader 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 per il modello a oggetti document (DOM).

Vedi anche

Si applica a