XmlDocument.Load Méthode

Définition

Charge les données XML spécifiées depuis un élément Stream, une URL, un élément TextReader ou un élément XmlReader.

Surcharges

Load(Stream)

Charge le document XML à partir du flux spécifié.

Load(TextReader)

Charge le document XML à partir de l'élément TextReader spécifié.

Load(String)

Charge le document XML à partir de l'URL spécifiée.

Load(XmlReader)

Charge le document XML à partir de l'élément XmlReader spécifié.

Load(Stream)

Charge le document XML à partir du flux spécifié.

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)

Paramètres

inStream
Stream

Flux contenant le document XML à charger.

Exceptions

Le fichier XML contient une erreur de chargement ou d’analyse. Dans ce cas, une FileNotFoundException est levée.

Remarques

Notes

La Load méthode conserve toujours les espaces blancs significatifs. La PreserveWhitespace propriété détermine si les espaces blancs non significatifs, c’est-à-dire les espaces blancs dans le contenu de l’élément, sont conservés. La valeur par défaut est false ; l’espace blanc dans le contenu de l’élément n’est pas conservé.

Si vous souhaitez que la validation se produise, vous pouvez créer une instance de validation à l' XmlReader aide de la XmlReaderSettings classe et de la Create méthode. Pour plus d'informations, consultez la section Notes de la page de référence XmlReader.

Cette méthode est une extension Microsoft du Document Object Model (DOM).

Cette méthode détecte automatiquement le format de chaîne du fichier XML d’entrée (par exemple, UTF-8, ANSI, etc.). Si votre application doit savoir quel encodage est utilisé pour lire le flux, envisagez d’utiliser un XmlTextReader objet pour lire le flux, puis utilisez la XmlTextReader.Encoding propriété pour déterminer l’encodage. Si vous devez utiliser un XmlDocument objet pour travailler avec du code XML, vous pouvez utiliser l' XmlTextReader objet pour en créer un. Pour plus d’informations, consultez lecture de données XML à l’aide de XPathDocument et XmlDocument.

Voir aussi

S’applique à

Load(TextReader)

Charge le document XML à partir de l'élément TextReader spécifié.

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)

Paramètres

txtReader
TextReader

L'élément TextReader utilisé pour introduire les données XML dans le document.

Exceptions

Le fichier XML contient une erreur de chargement ou d’analyse. Dans ce cas, le document reste vide.

Exemples

L’exemple suivant utilise la StringReader classe pour charger une chaîne de données XML dans l' XmlDocument objet.

#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

Remarques

Notes

La Load méthode conserve toujours les espaces blancs significatifs. La PreserveWhitespace propriété détermine si les espaces blancs non significatifs, c’est-à-dire les espaces blancs dans le contenu de l’élément, sont conservés. La valeur par défaut est false ; l’espace blanc dans le contenu de l’élément n’est pas conservé.

Si vous souhaitez que la validation se produise, vous pouvez créer une instance de validation à l' XmlReader aide de la XmlReaderSettings classe et de la Create méthode. Pour plus d'informations, consultez la section Notes de la page de référence XmlReader.

Cette méthode est une extension Microsoft du Document Object Model (DOM).

Voir aussi

S’applique à

Load(String)

Charge le document XML à partir de l'URL spécifiée.

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)

Paramètres

filename
String

URL du fichier contenant le document XML à charger. L'URL peut être un fichier local ou une URL HTTP (adresse web).

Exceptions

Le fichier XML contient une erreur de chargement ou d’analyse. Dans ce cas, une FileNotFoundException est levée.

filename est une chaîne de longueur nulle, contient seulement un espace, ou contient un ou plusieurs caractères non valides définis par InvalidPathChars.

filename a la valeur null.

Le chemin et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système.

Le chemin spécifié n’est pas valide (par exemple, il est sur un lecteur non mappé).

Une erreur d’E/S s’est produite lors de l’ouverture du fichier.

filename a spécifié un fichier en lecture seule.

  • ou - Cette opération n'est pas prise en charge sur la plateforme actuelle.

  • ou - filename a spécifié un répertoire.

  • ou - L'appelant n'a pas l'autorisation requise.

Le fichier spécifié dans filename est introuvable.

filename est dans un format non valide.

L'appelant n'a pas l'autorisation requise.

Remarques

Notes

La Load méthode conserve toujours les espaces blancs significatifs. La PreserveWhitespace propriété détermine si les espaces blancs non significatifs, c’est-à-dire les espaces blancs dans le contenu de l’élément, sont conservés. La valeur par défaut est false ; l’espace blanc dans le contenu de l’élément n’est pas conservé.

Si vous souhaitez que la validation se produise, vous pouvez créer une instance de validation à l' XmlReader aide de la XmlReaderSettings classe et de la Create méthode. Pour plus d'informations, consultez la section Notes de la page de référence XmlReader.

Cette méthode est une extension Microsoft du Document Object Model (DOM).

Voir aussi

S’applique à

Load(XmlReader)

Charge le document XML à partir de l'élément XmlReader spécifié.

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)

Paramètres

reader
XmlReader

L'élément XmlReader utilisé pour introduire les données XML dans le document.

Exceptions

Le fichier XML contient une erreur de chargement ou d’analyse. Dans ce cas, le document reste vide.

Exemples

L’exemple suivant charge le dernier nœud book du books.xml fichier dans le document 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

L’exemple utilise le fichier, books.xml , comme entrée.

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

Remarques

Notes

La Load méthode conserve toujours les espaces blancs significatifs. La PreserveWhitespace propriété détermine si les espaces blancs non significatifs, c’est-à-dire les espaces blancs dans le contenu de l’élément, sont conservés. La valeur par défaut est false ; l’espace blanc dans le contenu de l’élément n’est pas conservé.

Si le lecteur est dans l’état initial ( ReadState =ReadState.Initial), Load consomme tout le contenu du lecteur et génère le DOM à partir de ce qu’il trouve.

Si le lecteur est déjà positionné sur un nœud à la profondeur « n », cette méthode charge ce nœud et tous les frères suivants jusqu’à la balise de fin qui ferme la profondeur « n ». Les résultats sont les suivants.

Si le nœud actuel et ses frères se présentent comme suit :

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

Load lève une exception, car un document ne peut pas avoir deux éléments de niveau racine. Si le nœud actuel et ses frères se présentent comme suit :

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

Load réussie, mais vous avez une arborescence DOM incomplète, car il n’y a pas d’élément de niveau racine. Avant d’enregistrer le document, vous devez ajouter un élément de niveau racine, sinon Save une exception sera levée.

Si le lecteur est positionné sur un nœud terminal qui n’est pas valide pour le niveau racine d’un document, par exemple un espace blanc ou un nœud d’attribut, le lecteur continue à lire jusqu’à ce qu’il soit positionné sur un nœud qui peut être utilisé pour la racine. Le chargement du document démarre à ce stade.

Si vous souhaitez que la validation se produise, vous pouvez créer une instance de validation à l' XmlReader aide de la XmlReaderSettings classe et de la Create méthode. Pour plus d'informations, consultez la section Notes de la page de référence XmlReader.

Cette méthode est une extension Microsoft du Document Object Model (DOM).

Voir aussi

S’applique à