Partager via

XmlDocument.Save Méthode

Définition

Espace de noms:
System.Xml
Assemblys:
System.Xml.dll, System.Xml.XmlDocument.dll
Assemblys:
netstandard.dll, System.Xml.ReaderWriter.dll
Assembly:
System.Xml.XmlDocument.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll

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

Surcharges

Nom Description
Save(Stream)

Enregistre le document XML dans le flux spécifié.
Save(TextWriter)

Enregistre le document XML dans le fichier spécifié TextWriter.
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 le fichier spécifié XmlWriter.

Save(Stream)

Source:
XmlDocument.cs
Source:
XmlDocument.cs
Source:
XmlDocument.cs
Source:
XmlDocument.cs
Source:
XmlDocument.cs

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 souhaitez enregistrer.

Exceptions

XmlException

L’opération n’entraînerait pas de document XML bien formé (par exemple, aucun élément de document ni déclarations XML en double).

Remarques

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

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 fichier n’a pas de déclaration XmlDeclaration ou si xmlDeclaration n’a pas d’attribut d’encodage, le document enregistré n’en aura pas un.

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 modèle 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)

Source:
XmlDocument.cs
Source:
XmlDocument.cs
Source:
XmlDocument.cs
Source:
XmlDocument.cs
Source:
XmlDocument.cs

Enregistre le document XML dans le fichier spécifié TextWriter.

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

Auquel TextWriter vous souhaitez enregistrer.

Exceptions

XmlException

L’opération n’entraînerait pas de document XML bien formé (par exemple, aucun élément de document ni déclarations XML en double).

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 a pas eu d’encodage spécifié sur le TextWriter, il XmlDocument est enregistré sans attribut d’encodage.

Cette méthode est une extension Microsoft au modèle 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)

Source:
XmlDocument.cs
Source:
XmlDocument.cs
Source:
XmlDocument.cs
Source:
XmlDocument.cs
Source:
XmlDocument.cs

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 dans lequel vous souhaitez enregistrer le document.

Exceptions

XmlException

L’opération n’entraînerait pas de document XML bien formé (par exemple, aucun élément de document ni déclarations XML en double).

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;
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 sur true.

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 fichier n’a pas de déclaration XmlDeclaration ou si xmlDeclaration n’a pas d’attribut d’encodage, le document enregistré n’en aura pas un.

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 modèle 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)

Source:
XmlDocument.cs
Source:
XmlDocument.cs
Source:
XmlDocument.cs
Source:
XmlDocument.cs
Source:
XmlDocument.cs

Enregistre le document XML dans le fichier spécifié XmlWriter.

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

Auquel XmlWriter vous souhaitez enregistrer.

Exceptions

XmlException

L’opération n’entraînerait pas de document XML bien formé (par exemple, aucun élément de document ni déclarations XML en double).

Exemples

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

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 code détermine l’encodage écrit (l’encodage du nœud XmlDeclaration est remplacé par l’encodage du XmlWriter). S’il n’y a pas eu d’encodage spécifié sur le XmlWriter, il XmlDocument 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 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é.

Voir aussi

S’applique à