XmlDocument.Save Yöntem

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Xml.ReaderWriter.dll

XML belgesini belirtilen konuma kaydeder.

Aşırı Yüklemeler

Name	Description
Save(Stream)	XML belgesini belirtilen akışa kaydeder.
Save(TextWriter)	XML belgesini belirtilen TextWriteröğesine kaydeder.
Save(String)	XML belgesini belirtilen dosyaya kaydeder. Belirtilen dosya varsa, bu yöntem dosyanın üzerine yazar.
Save(XmlWriter)	XML belgesini belirtilen XmlWriteröğesine kaydeder.

Save(Stream)

Kaynak:

XmlDocument.cs

XML belgesini belirtilen akışa kaydeder.

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)

Parametreler

outStream

Stream

Kaydetmek istediğiniz akış.

Özel durumlar

XmlException

İşlem, iyi biçimlendirilmiş bir XML belgesine (örneğin, belge öğesi veya yinelenen XML bildirimleri) neden olmaz.

Açıklamalar

Boşluk yalnızca olarak ayarlandıysa PreserveWhitespacetruekorunur.

Kaydedilen belgedeki kodlama özniteliğini geçerli XmlDocument nesnenin XmlDeclaration'sı belirler. Kodlama özniteliğinin değeri özelliğinden XmlDeclaration.Encoding alınır. öğesinde XmlDocument XmlDeclaration yoksa veya XmlDeclaration'ın bir kodlama özniteliği yoksa, kaydedilen belgede de bir tane olmaz.

Belge kaydedildiğinde, düğüm kimliğini (yerel ad + ad alanı URI'sı) doğru bir şekilde kalıcı hale getirmek için xmlns öznitelikleri oluşturulur. Örneğin, aşağıdaki C# kodu

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

bu xmls özniteliğini <item xmls="urn:1"/>oluşturur.

Bu yöntem, Belge Nesne Modeli'nin (DOM) Bir Microsoft uzantısıdır.

Yalnızca yönteminin Save iyi biçimlendirilmiş bir XML belgesini zorunlu kıldığını unutmayın. Diğer Save tüm aşırı yüklemeler yalnızca iyi biçimlendirilmiş bir parça garanti eder.

Save(TextWriter)

Kaynak:

XmlDocument.cs

XML belgesini belirtilen TextWriteröğesine kaydeder.

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)

Parametreler

writer

TextWriter

TextWriter Kaydetmek istediğiniz.

Özel durumlar

XmlException

İşlem, iyi biçimlendirilmiş bir XML belgesine (örneğin, belge öğesi veya yinelenen XML bildirimleri) neden olmaz.

Açıklamalar

üzerindeki TextWriter kodlama, yazılan kodlamayı belirler (XmlDeclaration düğümünün kodlaması, öğesinin kodlaması TextWriterile değiştirilir). üzerinde TextWriterbelirtilen kodlama yoksa, XmlDocument kodlama özniteliği olmadan kaydedilir.

Bu yöntem, Belge Nesne Modeli'nin (DOM) Bir Microsoft uzantısıdır.

Yalnızca yönteminin Save iyi biçimlendirilmiş bir XML belgesini zorunlu kıldığını unutmayın. Diğer Save tüm aşırı yüklemeler yalnızca iyi biçimlendirilmiş bir parça garanti eder.

Save(String)

Kaynak:

XmlDocument.cs

XML belgesini belirtilen dosyaya kaydeder. Belirtilen dosya varsa, bu yöntem dosyanın üzerine yazar.

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)

Parametreler

filename

String

Belgeyi kaydetmek istediğiniz dosyanın konumu.

Özel durumlar

XmlException

İşlem, iyi biçimlendirilmiş bir XML belgesine (örneğin, belge öğesi veya yinelenen XML bildirimleri) neden olmaz.

Örnekler

Aşağıdaki örnek XML'yi bir XmlDocument nesnesine yükler, değiştirir ve data.xmladlı bir dosyaya kaydeder.

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

data.xml dosyası şu XML'yi içerir: <item><name>wrench</name><price>10.95</price></item>.

Açıklamalar

Çıkış dosyasında boşluk yalnızca olarak ayarlandıysa PreserveWhitespacetruekorunur.

Kaydedilen belgedeki kodlama özniteliğini geçerli XmlDocument nesnenin XmlDeclaration'sı belirler. Kodlama özniteliğinin değeri özelliğinden XmlDeclaration.Encoding alınır. öğesinde XmlDocument XmlDeclaration yoksa veya XmlDeclaration'ın bir kodlama özniteliği yoksa, kaydedilen belgede de bir tane olmaz.

Belge kaydedildiğinde, düğüm kimliğini (yerel ad + ad alanı URI'sı) doğru bir şekilde kalıcı hale getirmek için xmlns öznitelikleri oluşturulur. Örneğin, aşağıdaki C# kodu

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

bu xmls özniteliğini <item xmls="urn:1"/>oluşturur.

Bu yöntem, Belge Nesne Modeli'nin (DOM) Bir Microsoft uzantısıdır.

Yalnızca yönteminin Save iyi biçimlendirilmiş bir XML belgesini zorunlu kıldığını unutmayın. Diğer Save tüm aşırı yüklemeler yalnızca iyi biçimlendirilmiş bir parça garanti eder.

Save(XmlWriter)

Kaynak:

XmlDocument.cs

XML belgesini belirtilen XmlWriteröğesine kaydeder.

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)

Parametreler

w

XmlWriter

XmlWriter Kaydetmek istediğiniz.

Özel durumlar

XmlException

İşlem, iyi biçimlendirilmiş bir XML belgesine (örneğin, belge öğesi veya yinelenen XML bildirimleri) neden olmaz.

Örnekler

Aşağıdaki örnek XML'i bir XmlDocument nesneye yükler ve bir dosyaya kaydeder.

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

Açıklamalar

Boşluk yalnızca olarak ayarlandıysa PreserveWhitespacetruekorunur.

üzerindeki XmlWriter kodlama, yazılan kodlamayı belirler (XmlDeclaration düğümünün kodlaması, öğesinin kodlaması XmlWriterile değiştirilir). üzerinde XmlWriterbelirtilen kodlama yoksa, XmlDocument kodlama özniteliği olmadan kaydedilir.

Belge kaydedildiğinde, düğüm kimliğini (LocalName + NamespaceURI) doğru kalıcı hale getirmek için xmlns öznitelikleri oluşturulur. Örneğin, aşağıdaki C# kodu

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

şu xmls özniteliğini oluşturur:

<item
    xmls="urn:1"/>

Bu yöntem, Belge Nesne Modeli'nin (DOM) Bir Microsoft uzantısıdır.

Yalnızca yönteminin Save iyi biçimlendirilmiş bir XML belgesini zorunlu kıldığını unutmayın. Diğer Save tüm aşırı yüklemeler yalnızca iyi biçimlendirilmiş bir parça garanti eder.

Ayrıca bkz.

• Formatting