XmlDocument.Save Metódus

Definíció

Névtér:

System.Xml

Szerelvények:

netstandard.dll, System.Xml.ReaderWriter.dll

Menti az XML-dokumentumot a megadott helyre.

Túlterhelések

Name	Description
Save(Stream)	Menti az XML-dokumentumot a megadott streambe.
Save(TextWriter)	Menti az XML-dokumentumot a megadottba TextWriter.
Save(String)	Menti az XML-dokumentumot a megadott fájlba. Ha a megadott fájl létezik, ez a metódus felülírja azt.
Save(XmlWriter)	Menti az XML-dokumentumot a megadottba XmlWriter.

Save(Stream)

Forrás:

XmlDocument.cs

Menti az XML-dokumentumot a megadott streambe.

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)

Paraméterek

outStream

Stream

A menteni kívánt stream.

Kivételek

XmlException

A művelet nem eredményez jól formázott XML-dokumentumot (például nincs dokumentumelem vagy duplikált XML-deklaráció).

Megjegyzések

A szabad terület csak akkor marad meg, ha PreserveWhitespace be van állítva true.

Az aktuális XmlDocument objektum XmlDeclarációja határozza meg a mentett dokumentum kódolási attribútumát. A kódolási attribútum értéke a tulajdonságból származik XmlDeclaration.Encoding . Ha a XmlDocument dokumentum nem rendelkezik XmlDeclaration tulajdonságmal, vagy ha az XmlDeclaration nem rendelkezik kódolási attribútummal, a mentett dokumentum egyikével sem rendelkezik.

A dokumentum mentésekor xmlns-attribútumok jönnek létre a csomóponti identitás (helyi név + névtér URI) helyes megőrzéséhez. Például a következő C#-kód

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

ezt az xmls attribútumot <item xmls="urn:1"/>hozza létre.

Ez a metódus a Dokumentumobjektum-modell (DOM) Microsoft bővítménye.

Vegye figyelembe, hogy csak a metódus kényszeríti ki a Save jól formázott XML-dokumentumot. Minden más Save túlterhelés csak egy jól formázott töredéket garantál.

Save(TextWriter)

Forrás:

XmlDocument.cs

Menti az XML-dokumentumot a megadottba 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)

Paraméterek

writer

TextWriter

A TextWriter menteni kívánt fájl.

Kivételek

XmlException

A művelet nem eredményez jól formázott XML-dokumentumot (például nincs dokumentumelem vagy duplikált XML-deklaráció).

Megjegyzések

A kódolás a TextWriter kiírt kódolást határozza meg (Az XmlDeclaration csomópont kódolását felváltja a kódolás).TextWriter Ha nem adott meg kódolást a TextWriterprogram, a XmlDocument rendszer kódolási attribútum nélkül menti.

Ez a metódus a Dokumentumobjektum-modell (DOM) Microsoft bővítménye.

Vegye figyelembe, hogy csak a metódus kényszeríti ki a Save jól formázott XML-dokumentumot. Minden más Save túlterhelés csak egy jól formázott töredéket garantál.

Save(String)

Forrás:

XmlDocument.cs

Menti az XML-dokumentumot a megadott fájlba. Ha a megadott fájl létezik, ez a metódus felülírja azt.

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)

Paraméterek

filename

String

Annak a fájlnak a helye, ahová menteni szeretné a dokumentumot.

Kivételek

XmlException

A művelet nem eredményez jól formázott XML-dokumentumot (például nincs dokumentumelem vagy duplikált XML-deklaráció).

Példák

Az alábbi példa betölti az XML-t egy XmlDocument-objektumba, módosítja, majd egy data.xmlnevű fájlba menti.

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

A data.xml fájl a következő XML-fájlt tartalmazza: <item><name>wrench</name><price>10.95</price></item>.

Megjegyzések

A szabad terület csak akkor marad meg a kimeneti fájlban, ha PreserveWhitespace be van állítva true.

Az aktuális XmlDocument objektum XmlDeclarációja határozza meg a mentett dokumentum kódolási attribútumát. A kódolási attribútum értéke a tulajdonságból származik XmlDeclaration.Encoding . Ha a XmlDocument dokumentum nem rendelkezik XmlDeclaration tulajdonságmal, vagy ha az XmlDeclaration nem rendelkezik kódolási attribútummal, a mentett dokumentum egyikével sem rendelkezik.

A dokumentum mentésekor xmlns-attribútumok jönnek létre a csomóponti identitás (helyi név + névtér URI) helyes megőrzéséhez. Például a következő C#-kód

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

ezt az xmls attribútumot <item xmls="urn:1"/>hozza létre.

Ez a metódus a Dokumentumobjektum-modell (DOM) Microsoft bővítménye.

Vegye figyelembe, hogy csak a metódus kényszeríti ki a Save jól formázott XML-dokumentumot. Minden más Save túlterhelés csak egy jól formázott töredéket garantál.

Save(XmlWriter)

Forrás:

XmlDocument.cs

Menti az XML-dokumentumot a megadottba 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)

Paraméterek

w

XmlWriter

A XmlWriter menteni kívánt fájl.

Kivételek

XmlException

A művelet nem eredményez jól formázott XML-dokumentumot (például nincs dokumentumelem vagy duplikált XML-deklaráció).

Példák

Az alábbi példa betölti az XML-t egy XmlDocument objektumba, és menti egy fájlba.

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

Megjegyzések

A szabad terület csak akkor marad meg, ha PreserveWhitespace be van állítva true.

A kódolás a XmlWriter kiírt kódolást határozza meg (Az XmlDeclaration csomópont kódolását felváltja a kódolás).XmlWriter Ha nem adott meg kódolást a XmlWriterprogram, a XmlDocument rendszer kódolási attribútum nélkül menti.

A dokumentum mentésekor xmlns-attribútumok jönnek létre a csomóponti identitás (LocalName + NamespaceURI) helyes megőrzéséhez. Például a következő C#-kód

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

létrehozza ezt az xmls attribútumot:

<item
    xmls="urn:1"/>

Ez a metódus a Dokumentumobjektum-modell (DOM) Microsoft bővítménye.

Vegye figyelembe, hogy csak a metódus kényszeríti ki a Save jól formázott XML-dokumentumot. Minden más Save túlterhelés csak egy jól formázott töredéket garantál.

Lásd még

• Formatting