XmlDocument.Save Метод

Определение

Пространство имен:

System.Xml

Сборки:

netstandard.dll, System.Xml.ReaderWriter.dll

Сохраняет XML-документ в указанном расположении.

Перегрузки

Имя	Описание
Save(Stream)	Сохраняет XML-документ в указанном потоке.
Save(TextWriter)	Сохраняет XML-документ в указанный TextWriter.
Save(String)	Сохраняет XML-документ в указанный файл. Если указанный файл существует, этот метод перезаписывает его.
Save(XmlWriter)	Сохраняет XML-документ в указанный XmlWriter.

Save(Stream)

Исходный код:

XmlDocument.cs

Сохраняет XML-документ в указанном потоке.

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)

Параметры

outStream

Stream

Поток, в который требуется сохранить.

Исключения

XmlException

Операция не приведет к хорошо сформированным XML-документам (например, без элемента документа или повторяющихся xml-объявлений).

Комментарии

Пробел сохраняется только в том случае, если PreserveWhitespace задано значение true.

XmlDeclaration текущего XmlDocument объекта определяет атрибут кодирования в сохраненном документе. Значение атрибута кодирования берется из XmlDeclaration.Encoding свойства. XmlDocument Если у него нет xmlDeclaration или если xmlDeclaration не имеет атрибута кодирования, сохраненный документ не будет иметь ни одного.

При сохранении документа атрибуты xmlns создаются для сохранения удостоверения узла (локального имени и URI пространства имен). Например, следующий код C#

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

создает этот атрибут <item xmls="urn:1"/>XMLS.

Этот метод является расширением Майкрософт для объектной модели документов (DOM).

Обратите внимание, что только Save метод применяет хорошо сформированный XML-документ. Все остальные Save перегрузки гарантируют только хорошо сформированный фрагмент.

Save(TextWriter)

Исходный код:

XmlDocument.cs

Сохраняет XML-документ в указанный 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)

Параметры

writer

TextWriter

Значение TextWriter , в которое требуется сохранить.

Исключения

XmlException

Операция не приведет к хорошо сформированным XML-документам (например, без элемента документа или повторяющихся xml-объявлений).

Комментарии

Кодировка в TextWriter кодировании определяет кодирование, записанное (кодировка узла XmlDeclaration заменяется кодировкой объекта TextWriter). Если в кодировании TextWriterне указано, XmlDocument сохраняется без атрибута кодирования.

Этот метод является расширением Майкрософт для объектной модели документов (DOM).

Обратите внимание, что только Save метод применяет хорошо сформированный XML-документ. Все остальные Save перегрузки гарантируют только хорошо сформированный фрагмент.

Save(String)

Исходный код:

XmlDocument.cs

Сохраняет XML-документ в указанный файл. Если указанный файл существует, этот метод перезаписывает его.

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)

Параметры

filename

String

Расположение файла, в котором требуется сохранить документ.

Исключения

XmlException

Операция не приведет к хорошо сформированным XML-документам (например, без элемента документа или повторяющихся xml-объявлений).

Примеры

В следующем примере xml загружается в объект XmlDocument, изменяет его, а затем сохраняет его в файл с именем 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 будет содержать следующий XML-код: <item><name>wrench</name><price>10.95</price></item>

Комментарии

Пробел сохраняется в выходном файле, только если PreserveWhitespace задано значение true.

XmlDeclaration текущего XmlDocument объекта определяет атрибут кодирования в сохраненном документе. Значение атрибута кодирования берется из XmlDeclaration.Encoding свойства. XmlDocument Если у него нет xmlDeclaration или если xmlDeclaration не имеет атрибута кодирования, сохраненный документ не будет иметь ни одного.

При сохранении документа атрибуты xmlns создаются для сохранения удостоверения узла (локального имени и URI пространства имен). Например, следующий код C#

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

создает этот атрибут <item xmls="urn:1"/>XMLS.

Этот метод является расширением Майкрософт для объектной модели документов (DOM).

Обратите внимание, что только Save метод применяет хорошо сформированный XML-документ. Все остальные Save перегрузки гарантируют только хорошо сформированный фрагмент.

Save(XmlWriter)

Исходный код:

XmlDocument.cs

Сохраняет XML-документ в указанный 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)

Параметры

w

XmlWriter

Значение XmlWriter , в которое требуется сохранить.

Исключения

XmlException

Операция не приведет к хорошо сформированным XML-документам (например, без элемента документа или повторяющихся xml-объявлений).

Примеры

В следующем примере xml загружается в XmlDocument объект и сохраняется в файле.

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

Комментарии

Пробел сохраняется только в том случае, если PreserveWhitespace задано значение true.

Кодировка в XmlWriter кодировании определяет кодирование, записанное (кодировка узла XmlDeclaration заменяется кодировкой объекта XmlWriter). Если в кодировании XmlWriterне указано, XmlDocument сохраняется без атрибута кодирования.

При сохранении документа атрибуты xmlns создаются для сохранения удостоверения узла (LocalName + NamespaceURI). Например, следующий код C#

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

создает этот атрибут XMLS:

<item
    xmls="urn:1"/>

Этот метод является расширением Майкрософт для объектной модели документов (DOM).

Обратите внимание, что только Save метод применяет хорошо сформированный XML-документ. Все остальные Save перегрузки гарантируют только хорошо сформированный фрагмент.

См. также раздел

• Formatting