Partager via


XmlDocument.Save Méthode

Définition

Enregistre le document XML à l'emplacement spécifié.

Surcharges

Save(Stream)

Enregistre le document XML dans le flux spécifié.

Save(TextWriter)

Enregistre le document XML dans l'élément TextWriter spécifié.

Save(String)

Enregistre le document XML dans le fichier spécifié. Si le fichier spécifié existe, cette méthode le remplace.

Save(XmlWriter)

Enregistre le document XML dans l'élément XmlWriter spécifié.

Save(Stream)

Enregistre le document XML dans le flux spécifié.

public:
 virtual void Save(System::IO::Stream ^ outStream);
public virtual void Save (System.IO.Stream outStream);
abstract member Save : System.IO.Stream -> unit
override this.Save : System.IO.Stream -> unit
Public Overridable Sub Save (outStream As Stream)

Paramètres

outStream
Stream

Flux dans lequel vous voulez enregistrer.

Exceptions

L’opération ne se traduirait pas par un document XML bien formé (par exemple, aucun élément de document ou aucune double déclaration XML).

Remarques

L’espace blanc est conservé uniquement s’il PreserveWhitespace est défini truesur .

La déclaration XmlDeclaration de l’objet actif XmlDocument détermine l’attribut d’encodage dans le document enregistré. La valeur de l’attribut d’encodage est extraite de la XmlDeclaration.Encoding propriété. Si le XmlDocument document n’a pas de déclaration XmlDeclaration ou si xmlDeclaration n’a pas d’attribut d’encodage, le document enregistré n’en aura pas non plus.

Lorsque le document est enregistré, les attributs xmlns sont générés pour conserver correctement l’identité de nœud (nom local + URI d’espace de noms). Par exemple, le code C# suivant

XmlDocument doc = new XmlDocument();  
doc.AppendChild(doc.CreateElement("item","urn:1"));  
doc.Save(Console.Out);  

génère cet attribut <item xmls="urn:1"/>xmls .

Cette méthode est une extension Microsoft au dom (Document Object Model).

Notez que seule la Save méthode applique un document XML bien formé. Toutes les autres Save surcharges garantissent uniquement un fragment bien formé.

S’applique à

Save(TextWriter)

Enregistre le document XML dans l'élément TextWriter spécifié.

public:
 virtual void Save(System::IO::TextWriter ^ writer);
public virtual void Save (System.IO.TextWriter writer);
abstract member Save : System.IO.TextWriter -> unit
override this.Save : System.IO.TextWriter -> unit
Public Overridable Sub Save (writer As TextWriter)

Paramètres

writer
TextWriter

L'élément TextWriter dans lequel vous voulez enregistrer.

Exceptions

L’opération ne se traduirait pas par un document XML bien formé (par exemple, aucun élément de document ou aucune double déclaration XML).

Remarques

L’encodage sur le TextWriter code détermine l’encodage écrit (l’encodage du nœud XmlDeclaration est remplacé par l’encodage du TextWriter). S’il n’y avait pas d’encodage spécifié sur le TextWriter, il XmlDocument est enregistré sans attribut d’encodage.

Cette méthode est une extension Microsoft au dom (Document Object Model).

Notez que seule la Save méthode applique un document XML bien formé. Toutes les autres Save surcharges garantissent uniquement un fragment bien formé.

S’applique à

Save(String)

Enregistre le document XML dans le fichier spécifié. Si le fichier spécifié existe, cette méthode le remplace.

public:
 virtual void Save(System::String ^ filename);
public virtual void Save (string filename);
abstract member Save : string -> unit
override this.Save : string -> unit
Public Overridable Sub Save (filename As String)

Paramètres

filename
String

Emplacement du fichier où vous voulez enregistrer le document.

Exceptions

L’opération ne se traduirait pas par un document XML bien formé (par exemple, aucun élément de document ou aucune double déclaration XML).

Exemples

L’exemple suivant charge du code XML dans un objet XmlDocument, le modifie, puis l’enregistre dans un fichier nommé data.xml.

#using <System.Xml.dll>

using namespace System;
using namespace System::Xml;
int main()
{
   
   // Create the XmlDocument.
   XmlDocument^ doc = gcnew XmlDocument;
   doc->LoadXml( "<item><name>wrench</name></item>" );
   
   // Add a price element.
   XmlElement^ newElem = doc->CreateElement( "price" );
   newElem->InnerText = "10.95";
   doc->DocumentElement->AppendChild( newElem );
   
   // Save the document to a file. White space is
   // preserved (no white space).
   doc->PreserveWhitespace = true;
   doc->Save( "data.xml" );
}

using System;
using System.Xml;

public class Sample {

  public static void Main() {

    // Create the XmlDocument.
    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<item><name>wrench</name></item>");

    // Add a price element.
    XmlElement newElem = doc.CreateElement("price");
    newElem.InnerText = "10.95";
    doc.DocumentElement.AppendChild(newElem);

    // Save the document to a file. White space is
    // preserved (no white space).
    doc.PreserveWhitespace = true;
    doc.Save("data.xml");
  }
}
Imports System.Xml

public class Sample 

  public shared sub Main() 
 
    ' Create the XmlDocument.
    Dim doc as XmlDocument = new XmlDocument()
    doc.LoadXml("<item><name>wrench</name></item>")

    ' Add a price element.
    Dim newElem as XmlElement = doc.CreateElement("price")
    newElem.InnerText = "10.95"
    doc.DocumentElement.AppendChild(newElem)

    ' Save the document to a file. White space is
    ' preserved (no white space).
    doc.PreserveWhitespace = true
    doc.Save("data.xml")
 
  end sub
end class

Le fichier data.xml contient le code XML suivant : <item><name>wrench</name><price>10.95</price></item>.

Remarques

L’espace blanc est conservé dans le fichier de sortie uniquement s’il PreserveWhitespace est défini truesur .

La déclaration XmlDeclaration de l’objet actif XmlDocument détermine l’attribut d’encodage dans le document enregistré. La valeur de l’attribut d’encodage est extraite de la XmlDeclaration.Encoding propriété. Si le XmlDocument document n’a pas de déclaration XmlDeclaration ou si xmlDeclaration n’a pas d’attribut d’encodage, le document enregistré n’en aura pas non plus.

Lorsque le document est enregistré, les attributs xmlns sont générés pour conserver correctement l’identité de nœud (nom local + URI d’espace de noms). Par exemple, le code C# suivant

XmlDocument doc = new XmlDocument();  
doc.AppendChild(doc.CreateElement("item","urn:1"));  
doc.Save(Console.Out);  

génère cet attribut <item xmls="urn:1"/>xmls .

Cette méthode est une extension Microsoft au dom (Document Object Model).

Notez que seule la Save méthode applique un document XML bien formé. Toutes les autres Save surcharges garantissent uniquement un fragment bien formé.

S’applique à

Save(XmlWriter)

Enregistre le document XML dans l'élément XmlWriter spécifié.

public:
 virtual void Save(System::Xml::XmlWriter ^ w);
public virtual void Save (System.Xml.XmlWriter w);
abstract member Save : System.Xml.XmlWriter -> unit
override this.Save : System.Xml.XmlWriter -> unit
Public Overridable Sub Save (w As XmlWriter)

Paramètres

w
XmlWriter

L'élément XmlWriter dans lequel vous voulez enregistrer.

Exceptions

L’opération ne se traduirait pas par un document XML bien formé (par exemple, aucun élément de document ou aucune double déclaration XML).

Exemples

L’exemple suivant charge le code XML dans un XmlDocument objet et l’enregistre dans un fichier.

#using <System.Xml.dll>

using namespace System;
using namespace System::Xml;
int main()
{
   
   // Create the XmlDocument.
   XmlDocument^ doc = gcnew XmlDocument;
   doc->LoadXml( "<item><name>wrench</name></item>" );
   
   // Add a price element.
   XmlElement^ newElem = doc->CreateElement( "price" );
   newElem->InnerText = "10.95";
   doc->DocumentElement->AppendChild( newElem );
   
   // Save the document to a file and auto-indent the output.
   XmlTextWriter^ writer = gcnew XmlTextWriter( "data.xml", nullptr );
   writer->Formatting = Formatting::Indented;
   doc->Save( writer );
}

using System;
using System.Xml;

public class Sample {

  public static void Main() {

    // Create the XmlDocument.
    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<item><name>wrench</name></item>");

   // Add a price element.
   XmlElement newElem = doc.CreateElement("price");
   newElem.InnerText = "10.95";
   doc.DocumentElement.AppendChild(newElem);

   XmlWriterSettings settings = new XmlWriterSettings();
   settings.Indent = true;
   // Save the document to a file and auto-indent the output.
   XmlWriter writer = XmlWriter.Create("data.xml", settings);
    doc.Save(writer);
  }
}
Imports System.Xml

public class Sample 

  public shared sub Main() 
 
    ' Create the XmlDocument.
    Dim doc as XmlDocument = new XmlDocument()
    doc.LoadXml("<item><name>wrench</name></item>")

   ' Add a price element.
   Dim newElem as XmlElement = doc.CreateElement("price")
   newElem.InnerText = "10.95"
   doc.DocumentElement.AppendChild(newElem)

   Dim settings As New XmlWriterSettings()
   settings.Indent = True
   ' Save the document to a file and auto-indent the output.
   Dim writer As XmlWriter = XmlWriter.Create("data.xml", settings)
    doc.Save(writer)
  end sub
end class

Remarques

L’espace blanc est conservé uniquement s’il PreserveWhitespace est défini sur true.

L’encodage sur le XmlWriter fichier détermine l’encodage écrit (l’encodage du nœud XmlDeclaration est remplacé par l’encodage du fichier XmlWriter). S’il n’y a pas eu d’encodage spécifié sur le XmlWriter, le XmlDocument fichier est enregistré sans attribut d’encodage.

Lorsque le document est enregistré, les attributs xmlns sont générés pour conserver correctement l’identité de nœud (LocalName + NamespaceURI). Par exemple, le code C# suivant

XmlDocument doc = new XmlDocument();  
doc.AppendChild(doc.CreateElement("item","urn:1"));  
doc.Save(Console.Out);  

génère cet attribut xmls :

<item  
    xmls="urn:1"/>  

Cette méthode est une extension Microsoft au modèle objet document (DOM).

Notez que seule la Save méthode applique un document XML bien formé. Toutes les autres Save surcharges garantissent uniquement un fragment bien formé.

Voir aussi

S’applique à