XmlDocument.Save Yöntem

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

Özel durumlar

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.

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

Özel durumlar

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.

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

Özel durumlar

Ö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.

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

Özel durumlar

Ö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.

• Formatting