XmlDocument.Save Méthode

Référence

Définition

Espace de noms:: System.Xml

Assemblys:: System.Xml.dll, System.Xml.XmlDocument.dll

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.XmlDocument.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

XmlException

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

XmlException

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

XmlException

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 .

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

XmlException

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

Formatting

S’applique à

XmlDocument.Save Méthode

Définition

Surcharges

Save(Stream)

Paramètres

Exceptions

Remarques

S’applique à

Save(TextWriter)

Paramètres

Exceptions

Remarques

S’applique à

Save(String)

Paramètres

Exceptions

Exemples

Remarques

S’applique à

Save(XmlWriter)

Paramètres

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

Ressources supplémentaires