XmlDocument.Save XmlDocument.Save XmlDocument.Save XmlDocument.Save Method

Definition

Speichert das XML-Dokument am angegebenen Speicherort.Saves the XML document to the specified location.

Überlädt

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

Speichert das XML-Dokument im angegebenen Stream.Saves the XML document to the specified stream.

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

Speichert das XML-Dokument im angegebenen TextWriter.Saves the XML document to the specified TextWriter.

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

Speichert das XML-Dokument in der angegebenen Datei.Saves the XML document to the specified file. Die angegebene Datei existiert, diese Methode überschreibt sie.If the specified file exists, this method overwrites it.

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

Speichert das XML-Dokument im angegebenen XmlWriter.Saves the XML document to the specified XmlWriter.

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

Speichert das XML-Dokument im angegebenen Stream.Saves the XML document to the specified 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 Stream Stream Stream

Der Stream, in dem gespeichert werden soll.The stream to which you want to save.

Ausnahmen

Der Vorgang führt nicht zu einem wohlgeformten XML-Dokument (z. B. zu keinem Dokumentelement oder zu doppelten XML-Deklarationen).The operation would not result in a well formed XML document (for example, no document element or duplicate XML declarations).

Hinweise

Leerraum wird nur beibehalten, PreserveWhitespace wenn auf truefestgelegt ist.White space is preserved only if PreserveWhitespace is set to true.

Die XmlDeclaration des aktuellen XmlDocument -Objekts bestimmt das Codierungs Attribut im gespeicherten Dokument.The XmlDeclaration of the current XmlDocument object determines the encoding attribute in the saved document. Der Wert des Codierungs Attributs wird von der XmlDeclaration.Encoding -Eigenschaft entnommen.The value of the encoding attribute is taken from the XmlDeclaration.Encoding property. Wenn das XmlDocument keine XmlDeclaration hat oder wenn die XmlDeclaration über kein Codierungs Attribut verfügt, enthält das gespeicherte Dokument keines.If the XmlDocument does not have an XmlDeclaration, or if the XmlDeclaration does not have an encoding attribute, the saved document will not have one either.

Wenn das Dokument gespeichert wird, werden xmlns-Attribute generiert, um die Knoten Identität (lokaler Name und Namespace-URI) ordnungsgemäß beizubehalten.When the document is saved, xmlns attributes are generated to persist the node identity (local name + namespace URI) correctly. Der folgende C# Code wird z. b.For example, the following C# code

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

generiert dieses xmls- <item xmls="urn:1"/>Attribut.generates this xmls attribute <item xmls="urn:1"/>.

Diese Methode ist eine Microsoft-Erweiterung für die Dokumentobjektmodell (DOM).This method is a Microsoft extension to the Document Object Model (DOM).

Beachten Sie, dass Save nur die-Methode ein wohl geformtes XML-Dokument erzwingt.Note that only the Save method enforces a well-formed XML document. Alle anderen Save über Ladungen garantieren nur ein wohl geformtes Fragment.All other Save overloads only guarantee a well-formed fragment.

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

Speichert das XML-Dokument im angegebenen TextWriter.Saves the XML document to the specified 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 TextWriter TextWriter TextWriter

Der TextWriter, in dem gespeichert werden soll.The TextWriter to which you want to save.

Ausnahmen

Der Vorgang führt nicht zu einem wohlgeformten XML-Dokument (z. B. zu keinem Dokumentelement oder zu doppelten XML-Deklarationen).The operation would not result in a well formed XML document (for example, no document element or duplicate XML declarations).

Hinweise

Die Codierung auf der TextWriter bestimmt die Codierung, die geschrieben wird (die Codierung des Knotens XmlDeclaration wird durch die Codierung TextWritervon ersetzt).The encoding on the TextWriter determines the encoding that is written out (The encoding of the XmlDeclaration node is replaced by the encoding of the TextWriter). Wenn keine Codierung in TextWriterangegeben wurde, wird der XmlDocument ohne Codierungs Attribut gespeichert.If there was no encoding specified on the TextWriter, the XmlDocument is saved without an encoding attribute.

Diese Methode ist eine Microsoft-Erweiterung für die Dokumentobjektmodell (DOM).This method is a Microsoft extension to the Document Object Model (DOM).

Beachten Sie, dass Save nur die-Methode ein wohl geformtes XML-Dokument erzwingt.Note that only the Save method enforces a well-formed XML document. Alle anderen Save über Ladungen garantieren nur ein wohl geformtes Fragment.All other Save overloads only guarantee a well-formed fragment.

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

Speichert das XML-Dokument in der angegebenen Datei.Saves the XML document to the specified file. Die angegebene Datei existiert, diese Methode überschreibt sie.If the specified file exists, this method overwrites it.

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 String String String

Der Speicherort der Datei, in der Sie das Dokument speichern möchten.The location of the file where you want to save the document.

Ausnahmen

Der Vorgang führt nicht zu einem wohlgeformten XML-Dokument (z. B. zu keinem Dokumentelement oder zu doppelten XML-Deklarationen).The operation would not result in a well formed XML document (for example, no document element or duplicate XML declarations).

Beispiele

Im folgenden Beispiel wird XML in ein XmlDocument-Objekt geladen, geändert und dann in einer Datei namens "Data. xml" gespeichert.The following example loads XML into an XmlDocument object, modifies it, and then saves it to a file named data.xml.

#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 Datei "Data. xml" enthält den folgenden XML <item><name>wrench</name><price>10.95</price></item>-Code:.The data.xml file will contain the following XML: <item><name>wrench</name><price>10.95</price></item>.

Hinweise

Leerraum wird in der Ausgabedatei nur beibehalten, PreserveWhitespace wenn auf truefestgelegt ist.White space is preserved in the output file only if PreserveWhitespace is set to true.

Die XmlDeclaration des aktuellen XmlDocument -Objekts bestimmt das Codierungs Attribut im gespeicherten Dokument.The XmlDeclaration of the current XmlDocument object determines the encoding attribute in the saved document. Der Wert des Codierungs Attributs wird von der XmlDeclaration.Encoding -Eigenschaft entnommen.The value of the encoding attribute is taken from the XmlDeclaration.Encoding property. Wenn das XmlDocument keine XmlDeclaration hat oder wenn die XmlDeclaration über kein Codierungs Attribut verfügt, enthält das gespeicherte Dokument keines.If the XmlDocument does not have an XmlDeclaration, or if the XmlDeclaration does not have an encoding attribute, the saved document will not have one either.

Wenn das Dokument gespeichert wird, werden xmlns-Attribute generiert, um die Knoten Identität (lokaler Name und Namespace-URI) ordnungsgemäß beizubehalten.When the document is saved, xmlns attributes are generated to persist the node identity (local name + namespace URI) correctly. Der folgende C# Code wird z. b.For example, the following C# code

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

generiert dieses xmls- <item xmls="urn:1"/>Attribut.generates this xmls attribute <item xmls="urn:1"/>.

Diese Methode ist eine Microsoft-Erweiterung für die Dokumentobjektmodell (DOM).This method is a Microsoft extension to the Document Object Model (DOM).

Beachten Sie, dass Save nur die-Methode ein wohl geformtes XML-Dokument erzwingt.Note that only the Save method enforces a well-formed XML document. Alle anderen Save über Ladungen garantieren nur ein wohl geformtes Fragment.All other Save overloads only guarantee a well-formed fragment.

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

Speichert das XML-Dokument im angegebenen XmlWriter.Saves the XML document to the specified 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 XmlWriter XmlWriter XmlWriter

Der XmlWriter, in dem gespeichert werden soll.The XmlWriter to which you want to save.

Ausnahmen

Der Vorgang führt nicht zu einem wohlgeformten XML-Dokument (z. B. zu keinem Dokumentelement oder zu doppelten XML-Deklarationen).The operation would not result in a well formed XML document (for example, no document element or duplicate XML declarations).

Beispiele

Im folgenden Beispiel wird XML in ein XmlDocument -Objekt geladen und in einer Datei gespeichert.The following example loads XML into an XmlDocument object and saves it out to a file.

#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

Leerraum wird nur beibehalten, PreserveWhitespace wenn auf truefestgelegt ist.White space is preserved only if PreserveWhitespace is set to true.

Die Codierung auf der XmlWriter bestimmt die Codierung, die geschrieben wird (die Codierung des Knotens XmlDeclaration wird durch die Codierung XmlWritervon ersetzt).The encoding on the XmlWriter determines the encoding that is written out (The encoding of the XmlDeclaration node is replaced by the encoding of the XmlWriter). Wenn keine Codierung in XmlWriterangegeben wurde, wird der XmlDocument ohne Codierungs Attribut gespeichert.If there was no encoding specified on the XmlWriter, the XmlDocument is saved without an encoding attribute.

Wenn das Dokument gespeichert wird, werden xmlns-Attribute generiert, um die Knoten Identität (LocalName + NamespaceURI) ordnungsgemäß beizubehalten.When the document is saved, xmlns attributes are generated to persist the node identity (LocalName + NamespaceURI) correctly. Der folgende C# Code wird z. b.For example, the following C# code

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

generiert dieses xmls-Attribut:generates this xmls attribute:

<item  
    xmls="urn:1"/>  

Diese Methode ist eine Microsoft-Erweiterung für die Dokumentobjektmodell (DOM).This method is a Microsoft extension to the Document Object Model (DOM).

Beachten Sie, dass Save nur die-Methode ein wohl geformtes XML-Dokument erzwingt.Note that only the Save method enforces a well-formed XML document. Alle anderen Save über Ladungen garantieren nur ein wohl geformtes Fragment.All other Save overloads only guarantee a well-formed fragment.

Siehe auch

Gilt für: