XmlDocument.Save Methode

  • Referenz

Definition

Namespace:
System.Xml
Assemblys:
System.Xml.dll, System.Xml.XmlDocument.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.XmlDocument.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll

Speichert das XML-Dokument am angegebenen Speicherort.

Überlädt

Save(Stream)

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

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

Speichert das XML-Dokument in der angegebenen Datei. Die angegebene Datei existiert, diese Methode überschreibt sie.
Save(XmlWriter)

Speichert das XML-Dokument im angegebenen XmlWriter.

Save(Stream)

Speichert das XML-Dokument im angegebenen Stream.

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 Stream, in dem gespeichert werden soll.

Ausnahmen

XmlException

Der Vorgang führt nicht zu einem wohlgeformten XML-Dokument (z. B. zu keinem Dokumentelement oder zu doppelten XML-Deklarationen).

Hinweise

Leerzeichen werden nur beibehalten, wenn PreserveWhitespace auf " festgelegt" festgelegt trueist.

Die XmlDeclaration des aktuellen XmlDocument Objekts bestimmt das Codierungsattribute im gespeicherten Dokument. Der Wert des Codierungsattributes wird aus der XmlDeclaration.Encoding Eigenschaft übernommen. Wenn die XmlDocument XmlDeclaration nicht vorhanden ist oder wenn die XmlDeclaration kein Codierungsattribute besitzt, 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 Dokumentobjektmodell (DOM).

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

Gilt für

Save(TextWriter)

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, in dem gespeichert werden soll.

Ausnahmen

XmlException

Der Vorgang führt nicht zu einem wohlgeformten XML-Dokument (z. B. zu keinem Dokumentelement oder zu doppelten 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 TextWriterCodierungs-Attribut keine Codierung angegeben wurde, wird die XmlDocument Codierung ohne Codierungsattribute gespeichert.

Diese Methode ist eine Microsoft-Erweiterung für das Dokumentobjektmodell (DOM).

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

Gilt für

Save(String)

Speichert das XML-Dokument in der angegebenen Datei. Die angegebene Datei existiert, diese Methode überschreibt 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, in der Sie das Dokument speichern möchten.

Ausnahmen

XmlException

Der Vorgang führt nicht zu einem wohlgeformten XML-Dokument (z. B. zu keinem Dokumentelement oder zu doppelten XML-Deklarationen).

Beispiele

Im folgenden Beispiel wird XML in ein XmlDocument-Objekt geladen, geändert und anschließend in einer Datei mit dem Namen data.xml gespeichert.

#using <System.Xml.dll>

using namespace System;
using namespace System::Xml;
int main()
{
   
   // Create the XmlDocument.
   XmlDocument^ doc = gcnew 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" );
}


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 data.xml-Datei enthält die folgende XML-Datei: <item><name>wrench</name><price>10.95</price></item>

Hinweise

Leerzeichen werden nur in der Ausgabedatei beibehalten, wenn PreserveWhitespace sie auf true"." festgelegt ist.

Die XmlDeclaration des aktuellen XmlDocument Objekts bestimmt das Codierungsattribute im gespeicherten Dokument. Der Wert des Codierungsattributes wird aus der XmlDeclaration.Encoding Eigenschaft übernommen. Wenn die XmlDocument XmlDeclaration nicht vorhanden ist oder wenn die XmlDeclaration kein Codierungsattribute besitzt, 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 Dokumentobjektmodell (DOM).

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

Gilt für

Save(XmlWriter)

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, in dem gespeichert werden soll.

Ausnahmen

XmlException

Der Vorgang führt nicht zu einem wohlgeformten XML-Dokument (z. B. zu keinem Dokumentelement oder zu doppelten XML-Deklarationen).

Beispiele

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

#using <System.Xml.dll>

using namespace System;
using namespace System::Xml;
int main()
{
   
   // Create the XmlDocument.
   XmlDocument^ doc = gcnew 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 and auto-indent the output.
   XmlTextWriter^ writer = gcnew XmlTextWriter( "data.xml", nullptr );
   writer->Formatting = Formatting::Indented;
   doc->Save( writer );
}


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 werden nur beibehalten, wenn PreserveWhitespace auf " festgelegt" festgelegt trueist.

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 XmlWriterCodierungs-Attribut keine Codierung angegeben wurde, wird die XmlDocument Codierung ohne Codierungsattribute 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 Dokumentobjektmodell (DOM).

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

Siehe auch

Gilt für