XDocument.Save Metodo

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)

Parametri

Esempio

Nell'esempio seguente viene illustrato come salvare XDocument in 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())  

Nell'esempio viene prodotto l'output seguente:

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

Vedi anche

• WriteTo(XmlWriter)
• Load
• Parse
• Panoramica di LINQ to XML
• Come leggere e scrivere un documento codificato

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)

Parametri

Commenti

Il codice XML serializzato verrà rientro. Tutti gli spazi vuoti insignificanti verranno rimossi e verrà aggiunto spazio vuoto aggiuntivo in modo che l'XML venga rientro corretto. Il comportamento di questo metodo è che lo spazio vuoto insignificante non verrà mantenuto.

Se si vuole controllare lo spazio vuoto, usare l'overload di Save che accetta SaveOptions come parametro. Usare l'opzione DisableFormatting per salvare xml non rientri. In questo modo il writer scriverà tutti gli spazi vuoti esattamente come rappresentati nell'albero XML.

Usare OmitDuplicateNamespaces l'opzione se si desidera rimuovere dichiarazioni di spazio dei nomi duplicati.

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)

Parametri

Esempio

Nell'esempio seguente viene creato un XDocumentoggetto , viene salvato il documento in un StringWriteroggetto e quindi viene stampata la stringa nella 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())  

Nell'esempio viene prodotto l'output seguente:

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

Commenti

Il codice XML serializzato verrà rientro. Tutti gli spazi vuoti insignificanti verranno rimossi e verrà aggiunto spazio vuoto aggiuntivo in modo che l'XML venga rientro corretto. Il comportamento di questo metodo è che lo spazio vuoto insignificante non verrà mantenuto.

Se si vuole controllare lo spazio vuoto, usare l'overload di Save che accetta SaveOptions come parametro. Per altre informazioni, vedere Mantenere lo spazio vuoto durante il caricamento o l'analisi di XML e La conservazione dello spazio vuoto durante la serializzazione.

Vedi anche

• WriteTo(XmlWriter)
• Load
• Parse
• Panoramica di LINQ to XML
• Come leggere e scrivere un documento codificato

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

public void Save (string fileName);

member this.Save : string -> unit

Public Sub Save (fileName As String)

Parametri

Esempio

Nell'esempio seguente viene creato un XDocumentoggetto , viene salvato il documento in un file e quindi viene stampato il file nella 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"))  

Nell'esempio viene prodotto l'output seguente:

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

Commenti

Il codice XML serializzato verrà rientro. Tutti gli spazi vuoti insignificanti verranno rimossi e verrà aggiunto spazio vuoto aggiuntivo in modo che l'XML venga rientro corretto. Il comportamento di questo metodo è che lo spazio vuoto insignificante non verrà mantenuto.

Se si vuole controllare lo spazio vuoto, usare l'overload di Save che accetta SaveOptions come parametro. Per altre informazioni, vedere Mantenere lo spazio vuoto durante il caricamento o l'analisi di XML e La conservazione dello spazio vuoto durante la serializzazione.

Vedi anche

• WriteTo(XmlWriter)
• Load
• Parse
• Panoramica di LINQ to XML
• Come leggere e scrivere un documento codificato

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)

Parametri

Commenti

Per impostazione predefinita, l'oggetto options è impostato su None. Questa opzione rimuoverà tutti gli spazi vuoti extranei e aggiungerà spazi vuoti insignificanti appropriati in modo che il file XML venga rientro correttamente.

Se si vuole salvare il codice XML non rientro, specificare il DisableFormatting flag per options. In questo modo il writer scriverà tutti gli spazi vuoti esattamente come rappresentati nell'albero XML.

Usare OmitDuplicateNamespaces l'opzione se si desidera rimuovere dichiarazioni di spazio dei nomi duplicati.

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)

Parametri

Esempio

Nell'esempio seguente vengono illustrati due usi di questo metodo. Il primo uso serializza l'oggetto XDocument con la formattazione. Il secondo mantiene lo spazio vuoto. Poiché il documento non contiene spazi vuoti come costruito, mantiene lo spazio vuoto restituisce l'XML senza rientro.

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  

Nell'esempio viene prodotto l'output seguente:

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

Commenti

Se si vuole salvare il codice XML non rientro, specificare il DisableFormatting flag per options. In questo modo il writer scriverà tutti gli spazi vuoti esattamente come rappresentati nell'albero XML.

Se si vuole salvare xml con rientro, non specificare il DisableFormatting flag per options. Ciò rimuoverà tutti gli spazi vuoti irrilevanti e aggiungerà spazi vuoti significativi appropriati in modo che il file XML venga rientro correttamente. Si tratta del comportamento predefinito e del comportamento degli overload dei Save metodi che non accettano options come parametro.

Per altre informazioni, vedere Mantenere lo spazio vuoto durante il caricamento o l'analisi di XML e La conservazione dello spazio vuoto durante la serializzazione.

Vedi anche

• WriteTo(XmlWriter)
• Load
• Parse
• Panoramica di LINQ to XML
• Come leggere e scrivere un documento codificato

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)

Parametri

Esempio

Nell'esempio seguente vengono illustrati due usi di questo metodo. Il primo utilizzo mantiene lo spazio vuoto. Il secondo serializza l'oggetto XDocument con il rientro.

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"))  

Nell'esempio viene prodotto l'output seguente:

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

Commenti

Se si vuole salvare il codice XML non rientro, specificare il DisableFormatting flag per options. In questo modo il writer scriverà tutti gli spazi vuoti esattamente come rappresentati nell'albero XML.

Se si vuole salvare xml con rientro, non specificare il DisableFormatting flag per options. Ciò rimuoverà tutti gli spazi vuoti irrilevanti e aggiungerà spazi vuoti significativi appropriati in modo che il file XML venga rientro correttamente. Si tratta del comportamento predefinito e del comportamento degli overload dei Save metodi che non accettano options come parametro.

Per altre informazioni, vedere Mantenere lo spazio vuoto durante il caricamento o l'analisi di XML e La conservazione dello spazio vuoto durante la serializzazione.

Vedi anche

• WriteTo(XmlWriter)
• Load
• Parse
• Panoramica di LINQ to XML
• Procedura: Leggere e scrivere un documento codificato