Freigeben über

XmlDocument.Save Methode

Definition

Namespace:
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

Speichert das XML-Dokument an der angegebenen Position.

Überlädt

Name Beschreibung
Save(Stream)

Speichert das XML-Dokument im angegebenen Datenstrom.
Save(TextWriter)

Speichert das XML-Dokument im angegebenen TextWriter.
Save(String)

Speichert das XML-Dokument in der angegebenen Datei. Wenn die angegebene Datei vorhanden ist, überschreibt diese Methode sie.
Save(XmlWriter)

Speichert das XML-Dokument im angegebenen XmlWriter.

Save(Stream)

Quelle:
XmlDocument.cs
Quelle:
XmlDocument.cs
Quelle:
XmlDocument.cs
Quelle:
XmlDocument.cs
Quelle:
XmlDocument.cs

Speichert das XML-Dokument im angegebenen Datenstrom.

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)

Parameter

outStream
Stream

Der Datenstrom, in dem Sie speichern möchten.

Ausnahmen

XmlException

Der Vorgang würde nicht zu einem wohlgeformten XML-Dokument führen (z. B. kein Dokumentelement oder doppelte XML-Deklarationen).

Hinweise

Leerzeichen bleiben nur erhalten, wenn PreserveWhitespace sie auf true.

Die XmlDeclaration des aktuellen XmlDocument Objekts bestimmt das Codierungsattribut im gespeicherten Dokument. Der Wert des Codierungsattributs wird aus der XmlDeclaration.Encoding Eigenschaft übernommen. Wenn die XmlDocument XmlDeclaration nicht vorhanden ist oder wenn die XmlDeclaration nicht über ein Codierungsattribut verfügt, verfügt das gespeicherte Dokument auch nicht über eins.

Wenn das Dokument gespeichert wird, werden xmlns-Attribute generiert, um die Knotenidentität (lokaler Name + Namespace-URI) ordnungsgemäß zu speichern. Beispiel: der folgende C#-Code

XmlDocument doc = new XmlDocument();
doc.AppendChild(doc.CreateElement("item","urn:1"));
doc.Save(Console.Out);

generiert dieses XMLS-Attribut <item xmls="urn:1"/>.

Diese Methode ist eine Microsoft-Erweiterung für das Document Object Model (DOM).

Beachten Sie, dass nur die Save Methode ein wohlgeformtes XML-Dokument erzwingt. Alle anderen Save Überladungen garantieren nur ein wohlgeformtes Fragment.

Gilt für:

Save(TextWriter)

Quelle:
XmlDocument.cs
Quelle:
XmlDocument.cs
Quelle:
XmlDocument.cs
Quelle:
XmlDocument.cs
Quelle:
XmlDocument.cs

Speichert das XML-Dokument im angegebenen 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)

Parameter

writer
TextWriter

Der TextWriter Speicherort, in dem Sie speichern möchten.

Ausnahmen

XmlException

Der Vorgang würde nicht zu einem wohlgeformten XML-Dokument führen (z. B. kein Dokumentelement oder doppelte XML-Deklarationen).

Hinweise

Die Codierung für die TextWriter Codierung bestimmt die ausgeschriebene Codierung (die Codierung des XmlDeclaration-Knotens wird durch die Codierung der TextWriter). Wenn für das TextWriterAttribut keine Codierung angegeben wurde, wird die XmlDocument Codierung ohne Codierungsattribut gespeichert.

Diese Methode ist eine Microsoft-Erweiterung für das Document Object Model (DOM).

Beachten Sie, dass nur die Save Methode ein wohlgeformtes XML-Dokument erzwingt. Alle anderen Save Überladungen garantieren nur ein wohlgeformtes Fragment.

Gilt für:

Save(String)

Quelle:
XmlDocument.cs
Quelle:
XmlDocument.cs
Quelle:
XmlDocument.cs
Quelle:
XmlDocument.cs
Quelle:
XmlDocument.cs

Speichert das XML-Dokument in der angegebenen Datei. Wenn die angegebene Datei vorhanden ist, überschreibt diese Methode sie.

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)

Parameter

filename
String

Der Speicherort der Datei, an der Sie das Dokument speichern möchten.

Ausnahmen

XmlException

Der Vorgang würde nicht zu einem wohlgeformten XML-Dokument führen (z. B. kein Dokumentelement oder doppelte XML-Deklarationen).

Beispiele

Im folgenden Beispiel wird XML in ein XmlDocument-Objekt geladen, geändert und anschließend in einer Datei namens data.xmlgespeichert.

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

Die datei data.xml enthält die folgende XML: <item><name>wrench</name><price>10.95</price></item>.

Hinweise

Leerzeichen werden nur dann in der Ausgabedatei beibehalten, wenn PreserveWhitespace sie auf true.

Die XmlDeclaration des aktuellen XmlDocument Objekts bestimmt das Codierungsattribut im gespeicherten Dokument. Der Wert des Codierungsattributs wird aus der XmlDeclaration.Encoding Eigenschaft übernommen. Wenn die XmlDocument XmlDeclaration nicht vorhanden ist oder wenn die XmlDeclaration nicht über ein Codierungsattribut verfügt, verfügt das gespeicherte Dokument auch nicht über eins.

Wenn das Dokument gespeichert wird, werden xmlns-Attribute generiert, um die Knotenidentität (lokaler Name + Namespace-URI) ordnungsgemäß zu speichern. Beispiel: der folgende C#-Code

XmlDocument doc = new XmlDocument();
doc.AppendChild(doc.CreateElement("item","urn:1"));
doc.Save(Console.Out);

generiert dieses XMLS-Attribut <item xmls="urn:1"/>.

Diese Methode ist eine Microsoft-Erweiterung für das Document Object Model (DOM).

Beachten Sie, dass nur die Save Methode ein wohlgeformtes XML-Dokument erzwingt. Alle anderen Save Überladungen garantieren nur ein wohlgeformtes Fragment.

Gilt für:

Save(XmlWriter)

Quelle:
XmlDocument.cs
Quelle:
XmlDocument.cs
Quelle:
XmlDocument.cs
Quelle:
XmlDocument.cs
Quelle:
XmlDocument.cs

Speichert das XML-Dokument im angegebenen 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)

Parameter

w
XmlWriter

Der XmlWriter Speicherort, in dem Sie speichern möchten.

Ausnahmen

XmlException

Der Vorgang würde nicht zu einem wohlgeformten XML-Dokument führen (z. B. kein Dokumentelement oder doppelte XML-Deklarationen).

Beispiele

Im folgenden Beispiel wird XML in ein XmlDocument Objekt geladen und in einer Datei gespeichert.

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

Hinweise

Leerzeichen bleiben nur erhalten, wenn PreserveWhitespace sie auf true.

Die Codierung für die XmlWriter Codierung bestimmt die ausgeschriebene Codierung (die Codierung des XmlDeclaration-Knotens wird durch die Codierung der XmlWriter). Wenn für das XmlWriterAttribut keine Codierung angegeben wurde, wird die XmlDocument Codierung ohne Codierungsattribut gespeichert.

Wenn das Dokument gespeichert wird, werden xmlns-Attribute generiert, um die Knotenidentität (LocalName + NamespaceURI) ordnungsgemäß zu speichern. Beispiel: der folgende C#-Code

XmlDocument doc = new XmlDocument();
doc.AppendChild(doc.CreateElement("item","urn:1"));
doc.Save(Console.Out);

generiert dieses XMLS-Attribut:

<item
    xmls="urn:1"/>

Diese Methode ist eine Microsoft-Erweiterung für das Document Object Model (DOM).

Beachten Sie, dass nur die Save Methode ein wohlgeformtes XML-Dokument erzwingt. Alle anderen Save Überladungen garantieren nur ein wohlgeformtes Fragment.

Weitere Informationen

Gilt für: