XmlDocument.CreateXmlDeclaration(String, String, String) Método

Definição

Espaço de Nomes:
System.Xml
Assemblagens:
System.Xml.dll, System.Xml.XmlDocument.dll
Assemblagem:
System.Xml.dll
Assemblagem:
netstandard.dll

Cria um XmlDeclaration nó com os valores especificados.

public:
 virtual System::Xml::XmlDeclaration ^ CreateXmlDeclaration(System::String ^ version, System::String ^ encoding, System::String ^ standalone);
public virtual System.Xml.XmlDeclaration CreateXmlDeclaration(string version, string encoding, string standalone);
abstract member CreateXmlDeclaration : string * string * string -> System.Xml.XmlDeclaration
override this.CreateXmlDeclaration : string * string * string -> System.Xml.XmlDeclaration
Public Overridable Function CreateXmlDeclaration (version As String, encoding As String, standalone As String) As XmlDeclaration

Parâmetros

version
String

A versão deve ser "1.0".

encoding
String

O valor do atributo de codificação. Esta é a codificação usada quando se guarda XmlDocument num ficheiro ou fluxo; portanto, deve ser definida para uma string suportada pela Encoding classe, caso contrário Save(String) falha. Se isto for null ou String.Empty, o Save método não escreve um atributo de codificação na declaração XML e, por isso, é usada a codificação padrão, UTF-8.

Nota: Se o XmlDocument for guardado em a TextWriter ou num XmlTextWriter, este valor de codificação é descartado. Em vez disso, utiliza-se a codificação do TextWriter ou o XmlTextWriter . Isto garante que o XML escrito pode ser lido usando a codificação correta.

standalone
String

O valor deve ser "sim" ou "não". Se isto for null ou String.Empty, o Save método não escreve um atributo autónomo na declaração XML.

Devoluções

XmlDeclaration

O novo XmlDeclaration nó.

Exceções

ArgumentException

Os valores de version ou standalone são algo diferente dos especificados acima.

Exemplos

O exemplo seguinte cria uma declaração XML e adiciona-a ao documento.

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {
    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5'>" +
                "<title>Pride And Prejudice</title>" +
                "</book>");

    //Create an XML declaration.
    XmlDeclaration xmldecl;
    xmldecl = doc.CreateXmlDeclaration("1.0",null,null);

    //Add the new node to the document.
    XmlElement root = doc.DocumentElement;
    doc.InsertBefore(xmldecl, root);

    Console.WriteLine("Display the modified XML...");
    doc.Save(Console.Out);
  }
}

Option Explicit
Option Strict

Imports System.IO
Imports System.Xml

Public Class Sample
    
    Public Shared Sub Main()
        Dim doc As New XmlDocument()
        doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5'>" & _
                    "<title>Pride And Prejudice</title>" & _
                    "</book>")
        
        'Create an XML declaration. 
        Dim xmldecl As XmlDeclaration
        xmldecl = doc.CreateXmlDeclaration("1.0", Nothing, Nothing)
        
        'Add the new node to the document.
        Dim root As XmlElement = doc.DocumentElement
        doc.InsertBefore(xmldecl, root)
        
        Console.WriteLine("Display the modified XML...")
        doc.Save(Console.Out)
    End Sub
End Class

Observações

Os atributos são expostos como propriedades especiais no XmlDeclaration nó, e não como XmlAttribute nós.

Embora este método crie o novo objeto no contexto do documento, não adiciona automaticamente o novo objeto à árvore do documento. Para adicionar o novo objeto, deve chamar explicitamente um dos métodos de inserção de nó.

De acordo com a recomendação W3C Extensible Markup Language (XML) 1.0, o XmlDeclaration nó deve ser o primeiro nó no documento.

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

Aplica-se a

Ver também