XmlDocument.Load Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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).