XmlDocument.Save Metoda

Definicja

Przestrzeń nazw:

System.Xml

Zestawy:

netstandard.dll, System.Xml.ReaderWriter.dll

Zapisuje dokument XML w określonej lokalizacji.

Przeciążenia

Nazwa	Opis
Save(Stream)	Zapisuje dokument XML w określonym strumieniu.
Save(TextWriter)	Zapisuje dokument XML w określonym TextWriterpliku .
Save(String)	Zapisuje dokument XML w określonym pliku. Jeśli określony plik istnieje, ta metoda zastępuje go.
Save(XmlWriter)	Zapisuje dokument XML w określonym XmlWriterpliku .

Save(Stream)

Źródło:

XmlDocument.cs

Zapisuje dokument XML w określonym strumieniu.

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

Strumień, do którego chcesz zapisać.

Wyjątki

XmlException

Operacja nie spowoduje utworzenia dobrze sformułowanego dokumentu XML (na przykład bez elementu dokumentu ani zduplikowanych deklaracji XML).

Uwagi

Białe znaki są zachowywane tylko wtedy, gdy PreserveWhitespace jest ustawiona wartość true.

Właściwość XmlDeclaration bieżącego XmlDocument obiektu określa atrybut kodowania w zapisanym dokumencie. Wartość atrybutu kodowania jest pobierana z XmlDeclaration.Encoding właściwości . Jeśli obiekt XmlDocument nie ma atrybutu XmlDeclaration lub jeśli element XmlDeclaration nie ma atrybutu kodowania, zapisany dokument nie będzie miał ani jednego atrybutu.

Po zapisaniu dokumentu atrybuty xmlns są generowane w celu poprawnego utrwalania tożsamości węzła (lokalnej nazwy i identyfikatora URI przestrzeni nazw). Na przykład następujący kod w języku C#

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

generuje ten atrybut <item xmls="urn:1"/>xmls .

Ta metoda jest rozszerzeniem firmy Microsoft do modelu obiektów dokumentów (DOM).

Należy pamiętać, że tylko Save metoda wymusza poprawnie sformułowany dokument XML. Wszystkie inne Save przeciążenia gwarantują tylko dobrze sformułowany fragment.

Save(TextWriter)

Źródło:

XmlDocument.cs

Zapisuje dokument XML w określonym TextWriterpliku .

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

Element TextWriter , do którego chcesz zapisać.

Wyjątki

XmlException

Operacja nie spowoduje utworzenia dobrze sformułowanego dokumentu XML (na przykład bez elementu dokumentu ani zduplikowanych deklaracji XML).

Uwagi

Kodowanie w obiekcie TextWriter określa kodowanie, które zostało zapisane (kodowanie węzła XmlDeclaration jest zastępowane przez kodowanie elementu TextWriter). Jeśli w elemecie TextWriternie określono kodowania , XmlDocument parametr jest zapisywany bez atrybutu kodowania.

Ta metoda jest rozszerzeniem firmy Microsoft do modelu obiektów dokumentów (DOM).

Należy pamiętać, że tylko Save metoda wymusza poprawnie sformułowany dokument XML. Wszystkie inne Save przeciążenia gwarantują tylko dobrze sformułowany fragment.

Save(String)

Źródło:

XmlDocument.cs

Zapisuje dokument XML w określonym pliku. Jeśli określony plik istnieje, ta metoda zastępuje go.

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

Lokalizacja pliku, w którym chcesz zapisać dokument.

Wyjątki

XmlException

Operacja nie spowoduje utworzenia dobrze sformułowanego dokumentu XML (na przykład bez elementu dokumentu ani zduplikowanych deklaracji XML).

Przykłady

Poniższy przykład ładuje kod XML do obiektu XmlDocument, modyfikuje go, a następnie zapisuje go w pliku o nazwie 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

Plik data.xml będzie zawierać następujący kod XML: <item><name>wrench</name><price>10.95</price></item>.

Uwagi

Białe znaki są zachowywane w pliku wyjściowym tylko wtedy, gdy PreserveWhitespace jest ustawiona wartość true.

Właściwość XmlDeclaration bieżącego XmlDocument obiektu określa atrybut kodowania w zapisanym dokumencie. Wartość atrybutu kodowania jest pobierana z XmlDeclaration.Encoding właściwości . Jeśli obiekt XmlDocument nie ma atrybutu XmlDeclaration lub jeśli element XmlDeclaration nie ma atrybutu kodowania, zapisany dokument nie będzie miał ani jednego atrybutu.

Po zapisaniu dokumentu atrybuty xmlns są generowane w celu poprawnego utrwalania tożsamości węzła (lokalnej nazwy i identyfikatora URI przestrzeni nazw). Na przykład następujący kod w języku C#

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

generuje ten atrybut <item xmls="urn:1"/>xmls .

Ta metoda jest rozszerzeniem firmy Microsoft do modelu obiektów dokumentów (DOM).

Należy pamiętać, że tylko Save metoda wymusza poprawnie sformułowany dokument XML. Wszystkie inne Save przeciążenia gwarantują tylko dobrze sformułowany fragment.

Save(XmlWriter)

Źródło:

XmlDocument.cs

Zapisuje dokument XML w określonym XmlWriterpliku .

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

Element XmlWriter , do którego chcesz zapisać.

Wyjątki

XmlException

Operacja nie spowoduje utworzenia dobrze sformułowanego dokumentu XML (na przykład bez elementu dokumentu ani zduplikowanych deklaracji XML).

Przykłady

Poniższy przykład ładuje kod XML do XmlDocument obiektu i zapisuje go w pliku.

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

Uwagi

Białe znaki są zachowywane tylko wtedy, gdy PreserveWhitespace jest ustawiona wartość true.

Kodowanie w obiekcie XmlWriter określa kodowanie, które zostało zapisane (kodowanie węzła XmlDeclaration jest zastępowane przez kodowanie elementu XmlWriter). Jeśli w elemecie XmlWriternie określono kodowania , XmlDocument parametr jest zapisywany bez atrybutu kodowania.

Po zapisaniu dokumentu atrybuty xmlns są generowane w celu poprawnego utrwalania tożsamości węzła (LocalName + NamespaceURI). Na przykład następujący kod w języku C#

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

generuje ten atrybut xmls:

<item
    xmls="urn:1"/>

Ta metoda jest rozszerzeniem firmy Microsoft do modelu obiektów dokumentów (DOM).

Należy pamiętać, że tylko Save metoda wymusza poprawnie sformułowany dokument XML. Wszystkie inne Save przeciążenia gwarantują tylko dobrze sformułowany fragment.

Zobacz też

• Formatting