XmlDocument.Save Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

netstandard.dll, System.Xml.ReaderWriter.dll

Uloží dokument XML do zadaného umístění.

Přetížení

Name	Description
Save(Stream)	Uloží dokument XML do zadaného datového proudu.
Save(TextWriter)	Uloží dokument XML do zadaného TextWritersouboru .
Save(String)	Uloží dokument XML do zadaného souboru. Pokud zadaný soubor existuje, tato metoda jej přepíše.
Save(XmlWriter)	Uloží dokument XML do zadaného XmlWritersouboru .

Save(Stream)

Zdroj:

XmlDocument.cs

Uloží dokument XML do zadaného datového proudu.

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)

Parametry

outStream

Stream

Datový proud, do kterého chcete uložit.

Výjimky

XmlException

Operace by nezpůsobovala správně formátovaný dokument XML (například žádný prvek dokumentu nebo duplicitní deklarace XML).

Poznámky

Prázdné znaky se zachovají pouze v případě, že PreserveWhitespace je nastavená hodnota true.

XmlDeclaration aktuální XmlDocument objekt určuje kód atribut v uloženém dokumentu. Hodnota atributu kódování je převzata z XmlDeclaration.Encoding vlastnosti. XmlDocument Pokud xmlDeclaration nemá, nebo pokud XmlDeclaration nemá atribut kódování, uložený dokument nebude mít ani jeden.

Při uložení dokumentu se vygenerují atributy xmlns, aby se správně zachovala identita uzlu (místní název + identifikátor URI oboru názvů). Například následující kód jazyka C#

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

vygeneruje tento atribut <item xmls="urn:1"/>xmls .

Tato metoda je rozšířením Microsoftu pro model DOM (Document Object Model).

Všimněte si, že pouze Save metoda vynucuje správně formátovaný dokument XML. Všechna ostatní Save přetížení pouze zaručují dobře formátovaný fragment.

Save(TextWriter)

Zdroj:

XmlDocument.cs

Uloží dokument XML do zadaného TextWritersouboru .

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)

Parametry

writer

TextWriter

Do TextWriter kterého chcete uložit.

Výjimky

XmlException

Operace by nezpůsobovala správně formátovaný dokument XML (například žádný prvek dokumentu nebo duplicitní deklarace XML).

Poznámky

Kódování na TextWriter určuje kódování, které je zapsáno (kódování uzlu XmlDeclaration je nahrazeno kódováním TextWriter). Pokud nebylo zadáno TextWriteržádné kódování , uloží se XmlDocument bez atributu kódování.

Tato metoda je rozšířením Microsoftu pro model DOM (Document Object Model).

Všimněte si, že pouze Save metoda vynucuje správně formátovaný dokument XML. Všechna ostatní Save přetížení pouze zaručují dobře formátovaný fragment.

Save(String)

Zdroj:

XmlDocument.cs

Uloží dokument XML do zadaného souboru. Pokud zadaný soubor existuje, tato metoda jej přepíše.

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)

Parametry

filename

String

Umístění souboru, do kterého chcete dokument uložit.

Výjimky

XmlException

Operace by nezpůsobovala správně formátovaný dokument XML (například žádný prvek dokumentu nebo duplicitní deklarace XML).

Příklady

Následující příklad načte XML do XmlDocument objektu, upraví ho a pak jej uloží do souboru s názvem 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

Soubor data.xml bude obsahovat následující KÓD XML: <item><name>wrench</name><price>10.95</price></item>.

Poznámky

Prázdné znaky se ve výstupním souboru zachovají pouze v případě, že PreserveWhitespace je nastavená hodnota true.

XmlDeclaration aktuální XmlDocument objekt určuje kód atribut v uloženém dokumentu. Hodnota atributu kódování je převzata z XmlDeclaration.Encoding vlastnosti. XmlDocument Pokud xmlDeclaration nemá, nebo pokud XmlDeclaration nemá atribut kódování, uložený dokument nebude mít ani jeden.

Při uložení dokumentu se vygenerují atributy xmlns, aby se správně zachovala identita uzlu (místní název + identifikátor URI oboru názvů). Například následující kód jazyka C#

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

vygeneruje tento atribut <item xmls="urn:1"/>xmls .

Tato metoda je rozšířením Microsoftu pro model DOM (Document Object Model).

Všimněte si, že pouze Save metoda vynucuje správně formátovaný dokument XML. Všechna ostatní Save přetížení pouze zaručují dobře formátovaný fragment.

Save(XmlWriter)

Zdroj:

XmlDocument.cs

Uloží dokument XML do zadaného XmlWritersouboru .

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)

Parametry

w

XmlWriter

Do XmlWriter kterého chcete uložit.

Výjimky

XmlException

Operace by nezpůsobovala správně formátovaný dokument XML (například žádný prvek dokumentu nebo duplicitní deklarace XML).

Příklady

Následující příklad načte XML do objektu XmlDocument a uloží ho do souboru.

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

Poznámky

Prázdné znaky se zachovají pouze v případě, že PreserveWhitespace je nastavená hodnota true.

Kódování na XmlWriter určuje kódování, které je zapsáno (kódování uzlu XmlDeclaration je nahrazeno kódováním XmlWriter). Pokud nebylo zadáno XmlWriteržádné kódování , uloží se XmlDocument bez atributu kódování.

Při uložení dokumentu se vygenerují atributy xmlns, aby se správně zachovala identita uzlu (LocalName + NamespaceURI). Například následující kód jazyka C#

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

vygeneruje tento atribut xmls:

<item
    xmls="urn:1"/>

Tato metoda je rozšířením Microsoftu pro model DOM (Document Object Model).

Všimněte si, že pouze Save metoda vynucuje správně formátovaný dokument XML. Všechna ostatní Save přetížení pouze zaručují dobře formátovaný fragment.

Viz také

• Formatting