XDocument.Save XDocument.Save XDocument.Save XDocument.Save Method

Definition

Serialisiert dieses XDocument in eine Datei, einen TextWriter oder einen XmlWriter.Serializes this XDocument to a file, a TextWriter, or an XmlWriter.

Überlädt

Save(XmlWriter) Save(XmlWriter) Save(XmlWriter) Save(XmlWriter)

Serialisiert dieses XDocument in einen XmlWriter.Serialize this XDocument to an XmlWriter.

Save(Stream) Save(Stream) Save(Stream)

Gibt diesen XDocument an den angegebenen Stream aus.Outputs this XDocument to the specified Stream.

Save(TextWriter) Save(TextWriter) Save(TextWriter)

Serialisiert dieses XDocument in einen TextWriter.Serialize this XDocument to a TextWriter.

Save(String) Save(String) Save(String) Save(String)

Serialisieren Sie dieses XDocument in eine Datei, und überschreiben Sie dabei eine vorhandene Datei, sofern vorhanden.Serialize this XDocument to a file, overwriting an existing file, if it exists.

Save(Stream, SaveOptions) Save(Stream, SaveOptions) Save(Stream, SaveOptions)

Gibt dieses XDocument zum angegebenen Stream aus und gibt Formatierungsverhalten optional an.Outputs this XDocument to the specified Stream, optionally specifying formatting behavior.

Save(TextWriter, SaveOptions) Save(TextWriter, SaveOptions) Save(TextWriter, SaveOptions)

Serialisiert dieses XDocument in einen TextWriter, wobei optional die Formatierung deaktiviert wird.Serialize this XDocument to a TextWriter, optionally disabling formatting.

Save(String, SaveOptions) Save(String, SaveOptions) Save(String, SaveOptions) Save(String, SaveOptions)

Serialisiert dieses XDocument in eine Datei, wobei optional die Formatierung deaktiviert wird.Serialize this XDocument to a file, optionally disabling formatting.

Save(XmlWriter) Save(XmlWriter) Save(XmlWriter) Save(XmlWriter)

Serialisiert dieses XDocument in einen XmlWriter.Serialize this XDocument to an 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)

Parameter

writer
XmlWriter XmlWriter XmlWriter XmlWriter

Ein XmlWriter, in den das XDocument geschrieben wird.A XmlWriter that the XDocument will be written to.

Beispiele

Das folgende Beispiel zeigt die Vorgehensweise beim Speichern eines XDocument in einem XmlWriter.The following example shows how to save an XDocument to an 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())  

Dieses Beispiel erzeugt die folgende Ausgabe:This example produces the following output:

<Child>  
  <GrandChild>some content</GrandChild>  
</Child>  
Siehe auch

Save(Stream) Save(Stream) Save(Stream)

Gibt diesen XDocument an den angegebenen Stream aus.Outputs this XDocument to the specified Stream.

public:
 void Save(System::IO::Stream ^ stream);
public void Save (System.IO.Stream stream);
member this.Save : System.IO.Stream -> unit

Parameter

stream
Stream Stream Stream Stream

Der Stream, in den dieses XDocument ausgegeben werden soll.The stream to output this XDocument to.

Hinweise

Der serialisierte XML-Code wird eingezogen.The serialized XML will be indented. Alle unbedeutenden Leerräume werden entfernt, und es werden zusätzliche Leerzeichen hinzugefügt, sodass die XML-Daten ordnungsgemäß eingezogen werden.All insignificant white space will be removed, and additional white space will be added so that the XML will be properly indented. Das Verhalten dieser Methode besteht darin, dass unbedeutender Leerraum nicht beibehalten wird.The behavior of this method is that insignificant white space will not be preserved.

Wenn Sie Leerraum steuern möchten, verwenden Sie die-über Save Ladung von SaveOptions , die als Parameter annimmt.If you want to control white space, use the overload of Save that takes SaveOptions as a parameter. Verwenden Sie DisableFormatting die-Option, um nicht eingerückt-XML zu speichern.Use the DisableFormatting option to save unindented XML. Dadurch schreibt der Writer alle Leerräume genau so, wie er in der XML-Struktur dargestellt wird.This will cause the writer to write all white spaces exactly as represented in the XML tree.

Verwenden OmitDuplicateNamespaces Sie die Option, wenn Sie doppelte Namespace Deklarationen entfernen möchten.Use OmitDuplicateNamespaces option if you want to remove duplicate namespace declarations.

Save(TextWriter) Save(TextWriter) Save(TextWriter)

Serialisiert dieses XDocument in einen TextWriter.Serialize this XDocument to a TextWriter.

public:
 void Save(System::IO::TextWriter ^ textWriter);
public void Save (System.IO.TextWriter textWriter);
member this.Save : System.IO.TextWriter -> unit

Parameter

textWriter
TextWriter TextWriter TextWriter TextWriter

Ein TextWriter, in den das XDocument geschrieben wird.A TextWriter that the XDocument will be written to.

Beispiele

Im folgenden Beispiel wird ein XDocumenterstellt, das Dokument wird in StringWritereinem gespeichert, und anschließend wird die Zeichenfolge in der Konsole ausgegeben.The following example creates an XDocument, saves the document to a StringWriter, and then prints the string to the 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())  

Dieses Beispiel erzeugt die folgende Ausgabe:This example produces the following output:

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

Hinweise

Der serialisierte XML-Code wird eingezogen.The serialized XML will be indented. Alle unbedeutenden Leerräume werden entfernt, und es werden zusätzliche Leerzeichen hinzugefügt, sodass die XML-Daten ordnungsgemäß eingezogen werden.All insignificant white space will be removed, and additional white space will be added so that the XML will be properly indented. Das Verhalten dieser Methode besteht darin, dass unbedeutender Leerraum nicht beibehalten wird.The behavior of this method is that insignificant white space will not be preserved.

Wenn Sie Leerraum steuern möchten, verwenden Sie die-über Save Ladung von SaveOptions , die als Parameter annimmt.If you want to control white space, use the overload of Save that takes SaveOptions as a parameter. Weitere Informationen finden Sie unter beibehalten von Leerzeichen beim Laden oder überprüfen von XML und beibehalten von Leerraum während der Serialisierung.For more information, see Preserving White Space while Loading or Parsing XML and Preserving White Space While Serializing.

Siehe auch

Save(String) Save(String) Save(String) Save(String)

Serialisieren Sie dieses XDocument in eine Datei, und überschreiben Sie dabei eine vorhandene Datei, sofern vorhanden.Serialize this XDocument to a file, overwriting an existing file, if it exists.

public:
 void Save(System::String ^ fileName);
public void Save (string fileName);
member this.Save : string -> unit
Public Sub Save (fileName As String)

Parameter

fileName
String String String String

Eine Zeichenfolge, die den Namen der Datei enthält.A string that contains the name of the file.

Beispiele

Im folgenden Beispiel wird ein XDocumenterstellt, das Dokument wird in einer Datei gespeichert, und die Datei wird dann in der Konsole gedruckt.The following example creates an XDocument, saves the document to a file, and then prints the file to the 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"))  

Dieses Beispiel erzeugt die folgende Ausgabe:This example produces the following output:

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

Hinweise

Der serialisierte XML-Code wird eingezogen.The serialized XML will be indented. Alle unbedeutenden Leerräume werden entfernt, und es werden zusätzliche Leerzeichen hinzugefügt, sodass die XML-Daten ordnungsgemäß eingezogen werden.All insignificant white space will be removed, and additional white space will be added so that the XML will be properly indented. Das Verhalten dieser Methode besteht darin, dass unbedeutender Leerraum nicht beibehalten wird.The behavior of this method is that insignificant white space will not be preserved.

Wenn Sie Leerraum steuern möchten, verwenden Sie die-über Save Ladung von SaveOptions , die als Parameter annimmt.If you want to control white space, use the overload of Save that takes SaveOptions as a parameter. Weitere Informationen finden Sie unter beibehalten von Leerzeichen beim Laden oder überprüfen von XML und beibehalten von Leerraum während der Serialisierung.For more information, see Preserving White Space while Loading or Parsing XML and Preserving White Space While Serializing.

Siehe auch

Save(Stream, SaveOptions) Save(Stream, SaveOptions) Save(Stream, SaveOptions)

Gibt dieses XDocument zum angegebenen Stream aus und gibt Formatierungsverhalten optional an.Outputs this XDocument to the specified Stream, optionally specifying formatting behavior.

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

Parameter

stream
Stream Stream Stream Stream

Der Stream, in den dieses XDocument ausgegeben werden soll.The stream to output this XDocument to.

options
SaveOptions SaveOptions SaveOptions SaveOptions

Ein SaveOptions, das Formatierungsverhalten angibt.A SaveOptions that specifies formatting behavior.

Hinweise

Standardmäßig options ist auf Nonefestgelegt.By default the options are set to None. Mit dieser Option werden alle überflüssigen Leerzeichen entfernt, und es werden entsprechende unbedeutende Leerzeichen hinzugefügt, sodass der XML-Code ordnungsgemäß eingezogen ist.This option will remove all extraneous insignificant white space, and add appropriate insignificant white space so that the XML is properly indented.

Wenn Sie nicht eingerückt-XML speichern möchten, geben Sie DisableFormatting das- optionsFlag für an.If you want to save unindented XML, specify the DisableFormatting flag for options. Dadurch schreibt der Writer alle Leerräume genau so, wie er in der XML-Struktur dargestellt wird.This will cause the writer to write all white spaces exactly as represented in the XML tree.

Verwenden OmitDuplicateNamespaces Sie die Option, wenn Sie doppelte Namespace Deklarationen entfernen möchten.Use OmitDuplicateNamespaces option if you want to remove duplicate namespace declarations.

Save(TextWriter, SaveOptions) Save(TextWriter, SaveOptions) Save(TextWriter, SaveOptions)

Serialisiert dieses XDocument in einen TextWriter, wobei optional die Formatierung deaktiviert wird.Serialize this XDocument to a TextWriter, optionally disabling formatting.

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

Parameter

textWriter
TextWriter TextWriter TextWriter TextWriter

Der TextWriter, an den das XML ausgegeben werden soll.The TextWriter to output the XML to.

options
SaveOptions SaveOptions SaveOptions SaveOptions

Ein SaveOptions, das Formatierungsverhalten angibt.A SaveOptions that specifies formatting behavior.

Beispiele

Das folgende Beispiel zeigt zwei Verwendungen dieser Methode.The following example shows two uses of this method. Die erste Verwendung serialisiert XDocument mit Formatierung.The first use serializes the XDocument with formatting. Bei der zweiten wird Leerraum beibehalten.The second preserves white space. Da für das Dokument kein Leerraum vorhanden ist, wird der XML-Code ohne Einzug ausgegeben.Because the document has no white space in it as constructed, preserving white space outputs the XML without any indenting.

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  

Dieses Beispiel erzeugt die folgende Ausgabe:This example produces the following output:

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

Hinweise

Wenn Sie nicht eingerückt-XML speichern möchten, geben Sie DisableFormatting das- optionsFlag für an.If you want to save unindented XML, specify the DisableFormatting flag for options. Dadurch schreibt der Writer alle Leerräume genau so, wie er in der XML-Struktur dargestellt wird.This will cause the writer to write all white space exactly as represented in the XML tree.

Wenn Sie eingerückt-XML speichern möchten, geben Sie das DisableFormatting -Flag nicht für an. optionsIf you want to save indented XML, do not specify the DisableFormatting flag for options. Hierdurch werden alle überflüssigen Leerzeichen entfernt, und es werden entsprechende unbedeutende Leerzeichen hinzugefügt, sodass der XML-Code ordnungsgemäß eingezogen ist.This will remove all extraneous insignificant white space, and add appropriate insignificant white space so that the XML is properly indented. Dies ist das Standardverhalten und das Verhalten der über Ladungen Save der Methoden, die options nicht als Parameter akzeptieren.This is the default behavior, and the behavior of the overloads of the Save methods that do not take options as a parameter.

Weitere Informationen finden Sie unter beibehalten von Leerzeichen beim Laden oder überprüfen von XML und beibehalten von Leerraum während der Serialisierung.For more information, see Preserving White Space while Loading or Parsing XML and Preserving White Space While Serializing.

Siehe auch

Save(String, SaveOptions) Save(String, SaveOptions) Save(String, SaveOptions) Save(String, SaveOptions)

Serialisiert dieses XDocument in eine Datei, wobei optional die Formatierung deaktiviert wird.Serialize this XDocument to a file, optionally disabling formatting.

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)

Parameter

fileName
String String String String

Eine Zeichenfolge, die den Namen der Datei enthält.A string that contains the name of the file.

options
SaveOptions SaveOptions SaveOptions SaveOptions

Ein SaveOptions, das Formatierungsverhalten angibt.A SaveOptions that specifies formatting behavior.

Beispiele

Das folgende Beispiel zeigt zwei Verwendungen dieser Methode.The following example shows two uses of this method. Bei der ersten Verwendung wird Leerraum beibehalten.The first use preserves white space. Der zweite serialisiert den XDocument mit Einzug.The second one serializes the XDocument with indenting.

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

Dieses Beispiel erzeugt die folgende Ausgabe:This example produces the following output:

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

Hinweise

Wenn Sie nicht eingerückt-XML speichern möchten, geben Sie DisableFormatting das- optionsFlag für an.If you want to save unindented XML, specify the DisableFormatting flag for options. Dadurch schreibt der Writer alle Leerräume genau so, wie er in der XML-Struktur dargestellt wird.This will cause the writer to write all white space exactly as represented in the XML tree.

Wenn Sie eingerückt-XML speichern möchten, geben Sie das DisableFormatting -Flag nicht für an. optionsIf you want to save indented XML, do not specify the DisableFormatting flag for options. Hierdurch werden alle überflüssigen Leerzeichen entfernt, und es werden entsprechende unbedeutende Leerzeichen hinzugefügt, sodass der XML-Code ordnungsgemäß eingezogen ist.This will remove all extraneous insignificant white space, and add appropriate insignificant white space so that the XML is properly indented. Dies ist das Standardverhalten und das Verhalten der über Ladungen Save der Methoden, die options nicht als Parameter akzeptieren.This is the default behavior, and the behavior of the overloads of the Save methods that do not take options as a parameter.

Weitere Informationen finden Sie unter beibehalten von Leerzeichen beim Laden oder überprüfen von XML und beibehalten von Leerraum während der Serialisierung.For more information, see Preserving White Space while Loading or Parsing XML and Preserving White Space While Serializing.

Siehe auch

Gilt für: