XmlDocument.Save Metode

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Menyimpan dokumen XML ke lokasi yang ditentukan.

Overload

Nama	Deskripsi
Save(Stream)	Menyimpan dokumen XML ke aliran yang ditentukan.
Save(TextWriter)	Menyimpan dokumen XML ke yang ditentukan TextWriter.
Save(String)	Menyimpan dokumen XML ke file yang ditentukan. Jika file yang ditentukan ada, metode ini akan menimpanya.
Save(XmlWriter)	Menyimpan dokumen XML ke yang ditentukan XmlWriter.

Save(Stream)

Sumber:

XmlDocument.cs

Menyimpan dokumen XML ke aliran yang ditentukan.

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

Aliran yang ingin Anda simpan.

Pengecualian

XmlException

Operasi ini tidak akan menghasilkan dokumen XML yang terbentuk dengan baik (misalnya, tidak ada elemen dokumen atau deklarasi XML duplikat).

Keterangan

Spasi kosong dipertahankan hanya jika PreserveWhitespace diatur ke true.

XmlDeclaration objek saat ini XmlDocument menentukan atribut pengodean dalam dokumen yang disimpan. Nilai atribut pengodean diambil dari XmlDeclaration.Encoding properti . XmlDocument Jika tidak memiliki XmlDeclaration, atau jika XmlDeclaration tidak memiliki atribut pengodean, dokumen yang disimpan juga tidak akan memilikinya.

Saat dokumen disimpan, atribut xmlns dihasilkan untuk mempertahankan identitas simpul (nama lokal + URI namespace layanan) dengan benar. Misalnya, kode C# berikut

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

menghasilkan atribut <item xmls="urn:1"/>xml ini .

Metode ini adalah ekstensi Microsoft ke Model Objek Dokumen (DOM).

Perhatikan bahwa hanya metode yang Save memberlakukan dokumen XML yang terbentuk dengan baik. Semua kelebihan beban lainnya Save hanya menjamin fragmen yang terbentuk dengan baik.

Save(TextWriter)

Sumber:

XmlDocument.cs

Menyimpan dokumen XML ke yang ditentukan 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

yang TextWriter ingin Anda simpan.

Pengecualian

XmlException

Operasi ini tidak akan menghasilkan dokumen XML yang terbentuk dengan baik (misalnya, tidak ada elemen dokumen atau deklarasi XML duplikat).

Keterangan

Pengodean pada TextWriter menentukan pengodean yang ditulis (Pengodean simpul XmlDeclaration digantikan oleh pengodean TextWriter). Jika tidak ada pengodean yang ditentukan pada TextWriter, XmlDocument maka disimpan tanpa atribut pengodean.

Metode ini adalah ekstensi Microsoft ke Model Objek Dokumen (DOM).

Perhatikan bahwa hanya metode yang Save memberlakukan dokumen XML yang terbentuk dengan baik. Semua kelebihan beban lainnya Save hanya menjamin fragmen yang terbentuk dengan baik.

Save(String)

Sumber:

XmlDocument.cs

Menyimpan dokumen XML ke file yang ditentukan. Jika file yang ditentukan ada, metode ini akan menimpanya.

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

Lokasi file tempat Anda ingin menyimpan dokumen.

Pengecualian

XmlException

Operasi ini tidak akan menghasilkan dokumen XML yang terbentuk dengan baik (misalnya, tidak ada elemen dokumen atau deklarasi XML duplikat).

Contoh

Contoh berikut memuat XML ke dalam objek XmlDocument, memodifikasinya, lalu menyimpannya ke file bernama 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

File data.xml akan berisi XML berikut: <item><name>wrench</name><price>10.95</price></item>.

Keterangan

Spasi kosong dipertahankan dalam file output hanya jika PreserveWhitespace diatur ke true.

XmlDeclaration objek saat ini XmlDocument menentukan atribut pengodean dalam dokumen yang disimpan. Nilai atribut pengodean diambil dari XmlDeclaration.Encoding properti . XmlDocument Jika tidak memiliki XmlDeclaration, atau jika XmlDeclaration tidak memiliki atribut pengodean, dokumen yang disimpan juga tidak akan memilikinya.

Saat dokumen disimpan, atribut xmlns dihasilkan untuk mempertahankan identitas simpul (nama lokal + URI namespace layanan) dengan benar. Misalnya, kode C# berikut

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

menghasilkan atribut <item xmls="urn:1"/>xml ini .

Metode ini adalah ekstensi Microsoft ke Model Objek Dokumen (DOM).

Perhatikan bahwa hanya metode yang Save memberlakukan dokumen XML yang terbentuk dengan baik. Semua kelebihan beban lainnya Save hanya menjamin fragmen yang terbentuk dengan baik.

Save(XmlWriter)

Sumber:

XmlDocument.cs

Menyimpan dokumen XML ke yang ditentukan 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

yang XmlWriter ingin Anda simpan.

Pengecualian

XmlException

Operasi ini tidak akan menghasilkan dokumen XML yang terbentuk dengan baik (misalnya, tidak ada elemen dokumen atau deklarasi XML duplikat).

Contoh

Contoh berikut memuat XML ke dalam XmlDocument objek dan menyimpannya ke file.

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

Keterangan

Spasi kosong dipertahankan hanya jika PreserveWhitespace diatur ke true.

Pengodean pada XmlWriter menentukan pengodean yang ditulis (Pengodean simpul XmlDeclaration digantikan oleh pengodean XmlWriter). Jika tidak ada pengodean yang ditentukan pada XmlWriter, XmlDocument maka disimpan tanpa atribut pengodean.

Saat dokumen disimpan, atribut xmlns dihasilkan untuk mempertahankan identitas simpul (LocalName + NamespaceURI) dengan benar. Misalnya, kode C# berikut

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

menghasilkan atribut xml ini:

<item
    xmls="urn:1"/>

Metode ini adalah ekstensi Microsoft ke Model Objek Dokumen (DOM).

Perhatikan bahwa hanya metode yang Save memberlakukan dokumen XML yang terbentuk dengan baik. Semua kelebihan beban lainnya Save hanya menjamin fragmen yang terbentuk dengan baik.

Lihat juga

• Formatting