XmlDocument.Save Método

Definição

Espaço de Nomes:: System.Xml

Assemblagens:: System.Xml.dll, System.Xml.XmlDocument.dll

Assemblagens:: netstandard.dll, System.Xml.ReaderWriter.dll

Assemblagem:: System.Xml.XmlDocument.dll

Assemblagem:: System.Xml.ReaderWriter.dll

Assemblagem:: System.Xml.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Guarda o documento XML na localização especificada.

Sobrecargas

Name	Description
Save(Stream)	Guarda o documento XML no fluxo especificado.
Save(TextWriter)	Guarda o documento XML no arquivo especificado TextWriter.
Save(String)	Guarda o documento XML no ficheiro especificado. Se o ficheiro especificado existir, este método sobrescreve-o.
Save(XmlWriter)	Guarda o documento XML no arquivo especificado XmlWriter.

Save(Stream)

Origem:: XmlDocument.cs

Origem:: XmlDocument.cs

Origem:: XmlDocument.cs

Origem:: XmlDocument.cs

Origem:: XmlDocument.cs

Guarda o documento XML no fluxo especificado.

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)

Parâmetros

outStream: Stream

O stream para o qual queres guardar.

Exceções

XmlException

A operação não resultaria num documento XML bem formado (por exemplo, sem elemento de documento ou declarações XML duplicadas).

Observações

O espaço em branco é preservado apenas se PreserveWhitespace for definido como true.

O XmlDeclaration do objeto atual XmlDocument determina o atributo de codificação no documento guardado. O valor do atributo de codificação é retirado da XmlDeclaration.Encoding propriedade. Se não XmlDocument tiver um XmlDeclaration, ou se o XmlDeclaration não tiver um atributo de codificação, o documento guardado também não terá um.

Quando o documento é guardado, são gerados atributos xmlns para persistir corretamente a identidade do nó (nome local + URI do namespace). Por exemplo, o seguinte código C#

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

gera este atributo <item xmls="urn:1"/>xmls .

Este método é uma extensão da Microsoft para o Document Object Model (DOM).

Note que apenas o Save método impõe um documento XML bem estruturado. Todas as outras Save sobrecargas apenas garantem um fragmento bem formado.

Aplica-se a

Save(TextWriter)

Origem:: XmlDocument.cs

Origem:: XmlDocument.cs

Origem:: XmlDocument.cs

Origem:: XmlDocument.cs

Origem:: XmlDocument.cs

Guarda o documento XML no arquivo especificado 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)

Parâmetros

writer: TextWriter

O TextWriter que queres poupar.

Exceções

XmlException

A operação não resultaria num documento XML bem formado (por exemplo, sem elemento de documento ou declarações XML duplicadas).

Observações

A codificação em o TextWriter determina a codificação que é escrita (A codificação do nó XmlDeclaration é substituída pela codificação do TextWriter). Se não havia codificação especificada no TextWriter, o XmlDocument é guardado sem um atributo de codificação.

Este método é uma extensão da Microsoft para o Document Object Model (DOM).

Note que apenas o Save método impõe um documento XML bem estruturado. Todas as outras Save sobrecargas apenas garantem um fragmento bem formado.

Aplica-se a

Save(String)

Origem:: XmlDocument.cs

Origem:: XmlDocument.cs

Origem:: XmlDocument.cs

Origem:: XmlDocument.cs

Origem:: XmlDocument.cs

Guarda o documento XML no ficheiro especificado. Se o ficheiro especificado existir, este método sobrescreve-o.

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)

Parâmetros

filename: String

A localização do ficheiro onde queres guardar o documento.

Exceções

XmlException

A operação não resultaria num documento XML bem formado (por exemplo, sem elemento de documento ou declarações XML duplicadas).

Exemplos

O exemplo seguinte carrega XML num objeto XmlDocument, modifica-o e depois guarda num ficheiro chamado 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

O ficheiro data.xml conterá o seguinte XML: <item><name>wrench</name><price>10.95</price></item>.

Observações

O espaço em branco é preservado no ficheiro de saída apenas se PreserveWhitespace estiver definido para true.

Quando o documento é guardado, são gerados atributos xmlns para persistir corretamente a identidade do nó (nome local + URI do namespace). Por exemplo, o seguinte código C#

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

gera este atributo <item xmls="urn:1"/>xmls .

Este método é uma extensão da Microsoft para o Document Object Model (DOM).

Note que apenas o Save método impõe um documento XML bem estruturado. Todas as outras Save sobrecargas apenas garantem um fragmento bem formado.

Aplica-se a

Save(XmlWriter)

Origem:: XmlDocument.cs

Origem:: XmlDocument.cs

Origem:: XmlDocument.cs

Origem:: XmlDocument.cs

Origem:: XmlDocument.cs

Guarda o documento XML no arquivo especificado 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)

Parâmetros

w: XmlWriter

O XmlWriter que queres poupar.

Exceções

XmlException

A operação não resultaria num documento XML bem formado (por exemplo, sem elemento de documento ou declarações XML duplicadas).

Exemplos

O exemplo seguinte carrega XML num XmlDocument objeto e guarda-o num ficheiro.

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

Observações

O espaço em branco é preservado apenas se PreserveWhitespace for definido como true.

A codificação em o XmlWriter determina a codificação que é escrita (A codificação do nó XmlDeclaration é substituída pela codificação do XmlWriter). Se não havia codificação especificada no XmlWriter, o XmlDocument é guardado sem um atributo de codificação.

Quando o documento é guardado, são gerados atributos xmlns para persistir corretamente a identidade do nó (LocalName + NamespaceURI). Por exemplo, o seguinte código C#

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

Gera este atributo xmls:

<item
    xmls="urn:1"/>

Este método é uma extensão da Microsoft para o Document Object Model (DOM).

Note que apenas o Save método impõe um documento XML bem estruturado. Todas as outras Save sobrecargas apenas garantem um fragmento bem formado.

Ver também

Formatting

Aplica-se a

Comentários

Esta página foi útil?