Freigeben über


Serialisieren mit einer XML-Deklaration

Aktualisiert: November 2007

In diesem Thema wird beschrieben, wie Sie steuern können, ob die Serialisierung eine XML-Deklaration generiert.

Generierung einer XML-Deklaration

Bei der Serialisierung in eine File oder einen TextWriter mithilfe der XElement.Save-Methode oder der XDocument.Save-Methode wird eine XML-Deklaration generiert. Beim Serialisieren in einen XmlWriter bestimmen die (in einem XmlWriterSettings-Objekt angegebenen) Writer-Einstellungen, ob eine XML-Deklaration generiert wird.

Bei der Serialisierung in eine Zeichenfolge mithilfe der ToString-Methode enthält der resultierende XML-Code keine XML-Deklaration.

Serialisieren mit einer XML-Deklaration

Das folgende Beispiel erstellt ein XElement, speichert das Dokument in einer Datei und gibt die Datei dann auf der Konsole aus:

XElement root = new XElement("Root",
    new XElement("Child", "child content")
);
root.Save("Root.xml");
string str = File.ReadAllText("Root.xml");
Console.WriteLine(str);
Dim root As XElement = <Root>
                           <Child>child content</Child>
                       </Root>
root.Save("Root.xml")
Dim str As String = File.ReadAllText("Root.xml")
Console.WriteLine(str)

Dieses Beispiel führt zur folgenden Ausgabe:

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

Serialisieren ohne eine XML-Deklaration

Das folgende Beispiel zeigt die Vorgehensweise beim Speichern eines XElement in einem XmlWriter.

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

using (XmlWriter xw = XmlWriter.Create(sb, xws)) {
    XElement root = new XElement("Root",
        new XElement("Child", "child content")
    );
    root.Save(xw);
}
Console.WriteLine(sb.ToString());
Dim sb As StringBuilder = New StringBuilder()
Dim xws As XmlWriterSettings = New XmlWriterSettings()
xws.OmitXmlDeclaration = True

Using xw As XmlWriter = XmlWriter.Create(sb, xws)
    Dim root = <Root>
                   <Child>child content</Child>
               </Root>
    root.Save(xw)
End Using
Console.WriteLine(sb.ToString())

Dieses Beispiel führt zur folgenden Ausgabe:

<Root><Child>child content</Child></Root>

Siehe auch

Konzepte

Serialisieren von XML-Strukturen