XDocument.Save Méthode

Définition

Espace de noms:

System.Xml.Linq

Assembly:

System.Xml.XDocument.dll

Assembly:

System.Xml.Linq.dll

Assembly:

netstandard.dll

Sérialise ce XDocument vers un fichier, un TextWriter ou un XmlWriter.

Surcharges

Save(XmlWriter)	Sérialise ce XDocument vers un XmlWriter.
Save(Stream)	Renvoie ce XDocument vers le Stream spécifié.
Save(TextWriter)	Sérialise ce XDocument vers un TextWriter.
Save(String)	Sérialise ce XDocument dans un fichier, en remplaçant un fichier existant, le cas échéant.
Save(Stream, SaveOptions)	Génère ce XDocument vers le Stream spécifié, en précisant le cas échéant le comportement de mise en forme.
Save(TextWriter, SaveOptions)	Sérialise ce XDocument vers un TextWriter, en désactivant éventuellement la mise en forme.
Save(String, SaveOptions)	Sérialise ce XDocument vers un fichier, en désactivant éventuellement la mise en forme.

Save(XmlWriter)

Sérialise ce XDocument vers un XmlWriter.

public:
 void Save(System::Xml::XmlWriter ^ writer);

public void Save (System.Xml.XmlWriter writer);

member this.Save : System.Xml.XmlWriter -> unit

Public Sub Save (writer As XmlWriter)

Paramètres

writer

XmlWriter

XmlWriter dans lequel le XDocument sera écrit.

Exemples

L'exemple suivant montre comment enregistrer un objet XDocument dans un objet XmlWriter.

StringBuilder sb = new StringBuilder();  
XmlWriterSettings xws = new XmlWriterSettings();  
xws.OmitXmlDeclaration = true;  
xws.Indent = true;  

using (XmlWriter xw = XmlWriter.Create(sb, xws)) {  
    XDocument doc = new XDocument(  
        new XElement("Child",  
            new XElement("GrandChild", "some content")  
        )  
    );  
    doc.Save(xw);  
}  

Console.WriteLine(sb.ToString());  

Dim sb As StringBuilder = New StringBuilder()  
Dim xws As XmlWriterSettings = New XmlWriterSettings()  
xws.OmitXmlDeclaration = True  
xws.Indent = True  

Using xw = XmlWriter.Create(sb, xws)  
    Dim doc As XDocument = New XDocument(<Child><GrandChild>some content</GrandChild></Child>)  
    doc.Save(xw)  

End Using  

Console.WriteLine(sb.ToString())  

Cet exemple produit la sortie suivante :

<Child>  
  <GrandChild>some content</GrandChild>  
</Child>  

Voir aussi

• WriteTo(XmlWriter)
• Load
• Parse
• Vue d’ensemble de LINQ to XML
• Comment lire et écrire un document encodé

Save(Stream)

Renvoie ce XDocument vers le Stream spécifié.

public:
 void Save(System::IO::Stream ^ stream);

public void Save (System.IO.Stream stream);

member this.Save : System.IO.Stream -> unit

Public Sub Save (stream As Stream)

Paramètres

stream

Stream

Flux vers lequel générer ce XDocument.

Remarques

Le code XML sérialisé est mis en retrait. Tous les espaces blancs non significatifs seront supprimés et des espaces blancs supplémentaires seront ajoutés afin que le code XML soit correctement mis en retrait. Le comportement de cette méthode est que l’espace blanc non significatif ne sera pas conservé.

Si vous souhaitez contrôler l’espace blanc, utilisez la surcharge de Save ce SaveOptions paramètre. Utilisez l’option pour enregistrer le DisableFormatting code XML unindenté. Cela entraîne l’écriture de tous les espaces blancs exactement comme représenté dans l’arborescence XML.

Utilisez OmitDuplicateNamespaces l’option si vous souhaitez supprimer les déclarations d’espace de noms en double.

Save(TextWriter)

Sérialise ce XDocument vers un TextWriter.

public:
 void Save(System::IO::TextWriter ^ textWriter);

public void Save (System.IO.TextWriter textWriter);

member this.Save : System.IO.TextWriter -> unit

Public Sub Save (textWriter As TextWriter)

Paramètres

textWriter

TextWriter

TextWriter dans lequel le XDocument sera écrit.

Exemples

L’exemple suivant crée un XDocumentdocument , enregistre le document dans un StringWriter, puis imprime la chaîne dans la console.

StringBuilder sb = new StringBuilder();  

XDocument doc = new XDocument(  
    new XElement("Root",  
        new XElement("Child", "content")  
    )  
);  
TextWriter tr = new StringWriter(sb);  
doc.Save(tr);  
Console.WriteLine(sb.ToString());  

Dim sb As StringBuilder = New StringBuilder()  

Dim doc As XDocument = _   
    <?xml version="1.0" encoding="utf-8"?>  
        <Root><Child>content</Child></Root>  

Dim tr As TextWriter = New StringWriter(sb)  
doc.Save(tr)  
Console.WriteLine(sb.ToString())  

Cet exemple produit la sortie suivante :

<?xml version="1.0" encoding="utf-16"?>  
<Root>  
  <Child>content</Child>  
</Root>  

Remarques

Le code XML sérialisé est mis en retrait. Tous les espaces blancs non significatifs seront supprimés et des espaces blancs supplémentaires seront ajoutés afin que le code XML soit correctement mis en retrait. Le comportement de cette méthode est que l’espace blanc non significatif ne sera pas conservé.

Si vous souhaitez contrôler l’espace blanc, utilisez la surcharge de Save ce SaveOptions paramètre. Pour plus d’informations, consultez Conserver l’espace blanc lors du chargement ou de l’analyse du code XML et conserver l’espace blanc lors de la sérialisation.

Voir aussi

• WriteTo(XmlWriter)
• Load
• Parse
• Vue d’ensemble de LINQ to XML
• Comment lire et écrire un document encodé

Save(String)

Sérialise ce XDocument dans un fichier, en remplaçant un fichier existant, le cas échéant.

public:
 void Save(System::String ^ fileName);

public void Save (string fileName);

member this.Save : string -> unit

Public Sub Save (fileName As String)

Paramètres

fileName

String

Chaîne qui contient le nom du fichier.

Exemples

L’exemple suivant crée un XDocumentdocument , enregistre le document dans un fichier, puis imprime le fichier dans la console.

XDocument doc = new XDocument(  
    new XElement("Root",  
        new XElement("Child", "content")  
    )  
);  
doc.Save("Root.xml");  
Console.WriteLine(File.ReadAllText("Root.xml"));  

Dim doc As XDocument = _   
    <?xml version="1.0" encoding="utf-8"?>  
        <Root><Child>content</Child></Root>  

doc.Save("Root.xml")  
Console.WriteLine(File.ReadAllText("Root.xml"))  

Cet exemple produit la sortie suivante :

<?xml version="1.0" encoding="utf-8"?>  
<Root>  
  <Child>content</Child>  
</Root>  

Remarques

Le code XML sérialisé sera mis en retrait. Tous les espaces blancs non significatifs seront supprimés et des espaces blancs supplémentaires seront ajoutés afin que le code XML soit correctement mis en retrait. Le comportement de cette méthode est que l’espace blanc non significatif ne sera pas conservé.

Si vous souhaitez contrôler l’espace blanc, utilisez la surcharge qui Save prend SaveOptions comme paramètre. Pour plus d’informations, consultez Conserver l’espace blanc lors du chargement ou de l’analyse de XML et conserver des espaces blancs lors de la sérialisation.

Voir aussi

• WriteTo(XmlWriter)
• Load
• Parse
• Vue d’ensemble de LINQ to XML
• Comment lire et écrire un document encodé

Save(Stream, SaveOptions)

Génère ce XDocument vers le Stream spécifié, en précisant le cas échéant le comportement de mise en forme.

public:
 void Save(System::IO::Stream ^ stream, System::Xml::Linq::SaveOptions options);

public void Save (System.IO.Stream stream, System.Xml.Linq.SaveOptions options);

member this.Save : System.IO.Stream * System.Xml.Linq.SaveOptions -> unit

Public Sub Save (stream As Stream, options As SaveOptions)

Paramètres

stream

Stream

Flux vers lequel générer ce XDocument.

options

SaveOptions

SaveOptions qui spécifie le comportement de mise en forme.

Remarques

Par défaut, les options valeurs sont définies Nonesur . Cette option supprime tous les espaces non significatifs superflus et ajoute un espace blanc non significatif approprié afin que le code XML soit correctement mis en retrait.

Si vous souhaitez enregistrer du code XML unindenté, spécifiez l’indicateur DisableFormatting pour options. Cela entraîne l’écriture de tous les espaces blancs exactement comme représenté dans l’arborescence XML.

Utilisez OmitDuplicateNamespaces l’option si vous souhaitez supprimer les déclarations d’espace de noms en double.

Save(TextWriter, SaveOptions)

Sérialise ce XDocument vers un TextWriter, en désactivant éventuellement la mise en forme.

public:
 void Save(System::IO::TextWriter ^ textWriter, System::Xml::Linq::SaveOptions options);

public void Save (System.IO.TextWriter textWriter, System.Xml.Linq.SaveOptions options);

member this.Save : System.IO.TextWriter * System.Xml.Linq.SaveOptions -> unit

Public Sub Save (textWriter As TextWriter, options As SaveOptions)

Paramètres

textWriter

TextWriter

TextWriter vers lequel exporter le code XML.

options

SaveOptions

SaveOptions qui spécifie le comportement de mise en forme.

Exemples

L’exemple suivant montre deux utilisations de cette méthode. La première utilisation sérialise la XDocument mise en forme. La seconde conserve l’espace blanc. Étant donné que le document n’a pas d’espace blanc tel qu’il est construit, la conservation de l’espace blanc génère le code XML sans retrait.

XDocument doc = new XDocument(  
    new XElement("Root",  
        new XElement("Child", "content")  
    )  
);  
StringBuilder sb1 = new StringBuilder();  
using (StringWriter sr1 = new StringWriter(sb1)) {  
    doc.Save(sr1, SaveOptions.None);  
    Console.WriteLine(sb1.ToString());  
}  

StringBuilder sb2 = new StringBuilder();  
using (StringWriter sr2 = new StringWriter(sb2)) {  
    doc.Save(sr2, SaveOptions.DisableFormatting);  
    Console.WriteLine(sb2.ToString());  
}  

Dim doc As XDocument = _   
    <?xml version="1.0" encoding="utf-8"?>  
        <Root><Child>content</Child></Root>  

Dim sb1 As StringBuilder = New StringBuilder()  

Using sr1 = New StringWriter(sb1)  
    doc.Save(sr1, SaveOptions.None)  
    Console.WriteLine(sb1.ToString())  
End Using  

Dim sb2 As StringBuilder = New StringBuilder()  

Using sr2 = New StringWriter(sb2)  
    doc.Save(sr2, SaveOptions.DisableFormatting)  
    Console.WriteLine(sb2.ToString())  
End Using  

Cet exemple produit la sortie suivante :

<?xml version="1.0" encoding="utf-16"?>  
<Root>  
  <Child>content</Child>  
</Root>  
<?xml version="1.0" encoding="utf-16"?><Root><Child>content</Child></Root>  

Remarques

Si vous souhaitez enregistrer du code XML unindenté, spécifiez l’indicateur DisableFormatting pour options. Cela entraîne l’écriture de tout espace blanc tel qu’il est représenté dans l’arborescence XML.

Si vous souhaitez enregistrer le code XML mis en retrait, ne spécifiez pas l’indicateur DisableFormatting pour options. Cela permet de supprimer tous les espaces blancs superflus non significatifs et d’ajouter un espace blanc non significatif approprié afin que le code XML soit correctement mis en retrait. Il s’agit du comportement par défaut et du comportement des surcharges des Save méthodes qui ne prennent options pas en tant que paramètre.

Pour plus d’informations, consultez Conserver l’espace blanc lors du chargement ou de l’analyse de XML et conserver des espaces blancs lors de la sérialisation.

Voir aussi

• WriteTo(XmlWriter)
• Load
• Parse
• Vue d’ensemble de LINQ to XML
• Comment lire et écrire un document encodé

Save(String, SaveOptions)

Sérialise ce XDocument vers un fichier, en désactivant éventuellement la mise en forme.

public:
 void Save(System::String ^ fileName, System::Xml::Linq::SaveOptions options);

public void Save (string fileName, System.Xml.Linq.SaveOptions options);

member this.Save : string * System.Xml.Linq.SaveOptions -> unit

Public Sub Save (fileName As String, options As SaveOptions)

Paramètres

fileName

String

Chaîne qui contient le nom du fichier.

options

SaveOptions

SaveOptions qui spécifie le comportement de mise en forme.

Exemples

L’exemple suivant montre deux utilisations de cette méthode. La première utilisation conserve l’espace blanc. La deuxième sérialise le XDocument retrait.

XDocument doc = new XDocument(  
    new XElement("Root",  
        new XElement("Child", "content")  
    )  
);  
doc.Save("Root1.xml", SaveOptions.DisableFormatting);  
Console.WriteLine(File.ReadAllText("Root1.xml"));  
doc.Save("Root2.xml", SaveOptions.None);  
Console.WriteLine(File.ReadAllText("Root2.xml"));  

Dim doc As XDocument = _   
    <?xml version="1.0" encoding="utf-8"?>  
        <Root><Child>content</Child></Root>  

doc.Save("Root1.xml", SaveOptions.DisableFormatting)  
Console.WriteLine(File.ReadAllText("Root1.xml"))  
doc.Save("Root2.xml", SaveOptions.None)  
Console.WriteLine(File.ReadAllText("Root2.xml"))  

Cet exemple produit la sortie suivante :

<?xml version="1.0" encoding="utf-8"?><Root><Child>content</Child></Root>  
<?xml version="1.0" encoding="utf-8"?>  
<Root>  
  <Child>content</Child>  
</Root>  

Remarques

Si vous souhaitez enregistrer du code XML unindenté, spécifiez l’indicateur DisableFormatting pour options. Cela entraîne l’écriture de tout espace blanc tel qu’il est représenté dans l’arborescence XML.

Si vous souhaitez enregistrer le code XML mis en retrait, ne spécifiez pas l’indicateur DisableFormatting pour options. Cela permet de supprimer tous les espaces blancs superflus non significatifs et d’ajouter un espace blanc non significatif approprié afin que le code XML soit correctement mis en retrait. Il s’agit du comportement par défaut et du comportement des surcharges des Save méthodes qui ne prennent options pas en tant que paramètre.

Pour plus d’informations, consultez Conserver l’espace blanc lors du chargement ou de l’analyse de XML et conserver des espaces blancs lors de la sérialisation.

Voir aussi

• WriteTo(XmlWriter)
• Load
• Parse
• Vue d’ensemble de LINQ to XML
• Procédure : lire et écrire un document encodé