XmlDocument.Save Methode

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)

Parameters

Uitzonderingen

Opmerkingen

Witruimte blijft alleen behouden als PreserveWhitespace deze is ingesteld op true.

De XmlDeclaration van het huidige XmlDocument object bepaalt het coderingskenmerk in het opgeslagen document. De waarde van het coderingskenmerk wordt opgehaald uit de XmlDeclaration.Encoding eigenschap. Als de XmlDocument declaratie geen XmlDeclaration heeft of als de XmlDeclaration geen coderingskenmerk heeft, heeft het opgeslagen document er ook geen.

Wanneer het document wordt opgeslagen, worden xmlns-kenmerken gegenereerd om de knooppuntidentiteit (lokale naam en naamruimte-URI) correct te behouden. Bijvoorbeeld de volgende C#-code

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

genereert dit xmls-kenmerk <item xmls="urn:1"/>.

Deze methode is een Microsoft extensie voor het Document Object Model (DOM).

Houd er rekening mee dat alleen de Save methode een goed opgemaakt XML-document afdwingt. Alle andere Save overbelastingen garanderen alleen een goed gevormd fragment.

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)

Parameters

Uitzonderingen

Opmerkingen

De codering op de TextWriter codering bepaalt de codering die is geschreven (de codering van het XmlDeclaration-knooppunt wordt vervangen door de codering van het TextWriter). Als er geen codering is opgegeven op de TextWriter, wordt het XmlDocument opgeslagen zonder een coderingskenmerk.

Deze methode is een Microsoft extensie voor het Document Object Model (DOM).

Houd er rekening mee dat alleen de Save methode een goed opgemaakt XML-document afdwingt. Alle andere Save overbelastingen garanderen alleen een goed gevormd fragment.

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)

Parameters

Uitzonderingen

Voorbeelden

In het volgende voorbeeld wordt XML in een XmlDocument-object geladen, gewijzigd en vervolgens opgeslagen in een bestand met de naam 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

Het bestand data.xml bevat de volgende XML: <item><name>wrench</name><price>10.95</price></item>.

Opmerkingen

Witruimte blijft alleen behouden in het uitvoerbestand als PreserveWhitespace deze is ingesteld op true.

De XmlDeclaration van het huidige XmlDocument object bepaalt het coderingskenmerk in het opgeslagen document. De waarde van het coderingskenmerk wordt opgehaald uit de XmlDeclaration.Encoding eigenschap. Als de XmlDocument declaratie geen XmlDeclaration heeft of als de XmlDeclaration geen coderingskenmerk heeft, heeft het opgeslagen document er ook geen.

Wanneer het document wordt opgeslagen, worden xmlns-kenmerken gegenereerd om de knooppuntidentiteit (lokale naam en naamruimte-URI) correct te behouden. Bijvoorbeeld de volgende C#-code

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

genereert dit xmls-kenmerk <item xmls="urn:1"/>.

Deze methode is een Microsoft extensie voor het Document Object Model (DOM).

Houd er rekening mee dat alleen de Save methode een goed opgemaakt XML-document afdwingt. Alle andere Save overbelastingen garanderen alleen een goed gevormd fragment.

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)

Parameters

Uitzonderingen

Voorbeelden

In het volgende voorbeeld wordt XML in een XmlDocument object geladen en opgeslagen in een bestand.

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

Opmerkingen

Witruimte blijft alleen behouden als PreserveWhitespace deze is ingesteld op true.

De codering op de XmlWriter codering bepaalt de codering die is geschreven (de codering van het XmlDeclaration-knooppunt wordt vervangen door de codering van het XmlWriter). Als er geen codering is opgegeven op de XmlWriter, wordt het XmlDocument opgeslagen zonder een coderingskenmerk.

Wanneer het document wordt opgeslagen, worden xmlns-kenmerken gegenereerd om de knooppuntidentiteit (LocalName + NamespaceURI) correct te behouden. Bijvoorbeeld de volgende C#-code

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

genereert dit xmls-kenmerk:

<item
    xmls="urn:1"/>

Deze methode is een Microsoft extensie voor het Document Object Model (DOM).

Houd er rekening mee dat alleen de Save methode een goed opgemaakt XML-document afdwingt. Alle andere Save overbelastingen garanderen alleen een goed gevormd fragment.

Zie ook

• Formatting