Share via

XmlDocument.Save Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Xml
Bütünleştirilmiş Kodlar:
System.Xml.dll, System.Xml.XmlDocument.dll
Bütünleştirilmiş Kod:
System.Xml.ReaderWriter.dll
Bütünleştirilmiş Kod:
System.Xml.XmlDocument.dll
Bütünleştirilmiş Kod:
System.Xml.dll
Bütünleştirilmiş Kod:
netstandard.dll

XML belgesini belirtilen konuma kaydeder.

Aşırı Yüklemeler

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)

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 PreserveWhitespace olarak ayarlandığında truekorunur.

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

Belge kaydedildiğinde, düğüm kimliğini (yerel ad alanı URI'sini) 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çayı garanti eder.

Şunlara uygulanır

Save(TextWriter)

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ı, kodlaması TextWriterile değiştirilir). üzerinde TextWriterherhangi bir kodlama belirtilmemişse, 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çayı garanti eder.

Şunlara uygulanır

Save(String)

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

Dosyanın belgeyi kaydetmek istediğiniz 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.xml adlı bir dosyaya kaydeder.

#using <System.Xml.dll>

using namespace System;
using namespace System::Xml;
int main()
{
   
   // Create the XmlDocument.
   XmlDocument^ doc = gcnew 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" );
}


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 PreserveWhitespace boşluk yalnızca olarak ayarlandığında truekorunur.

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

Belge kaydedildiğinde, düğüm kimliğini (yerel ad alanı URI'sini) 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çayı garanti eder.

Şunlara uygulanır

Save(XmlWriter)

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'yi bir XmlDocument nesneye yükler ve bir dosyaya kaydeder.

#using <System.Xml.dll>

using namespace System;
using namespace System::Xml;
int main()
{
   
   // Create the XmlDocument.
   XmlDocument^ doc = gcnew 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 and auto-indent the output.
   XmlTextWriter^ writer = gcnew XmlTextWriter( "data.xml", nullptr );
   writer->Formatting = Formatting::Indented;
   doc->Save( writer );
}


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 PreserveWhitespace olarak ayarlandığında truekorunur.

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

Belge kaydedildiğinde, düğüm kimliğini (LocalName + NamespaceURI) 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);

ş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çayı garanti eder.

Ayrıca bkz.

Şunlara uygulanır