XmlDocument.CreateXmlDeclaration(String, String, String) Metode

Definisi

Ruang nama:

System.Xml

Rakitan:

System.Xml.ReaderWriter.dll

Sumber:

XmlDocument.cs

Membuat simpul XmlDeclaration dengan nilai yang ditentukan.

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

Parameter

version

String

Versi harus "1.0".

encoding

String

Nilai atribut pengodean. Ini adalah pengodean yang digunakan saat Anda menyimpan XmlDocument ke file atau aliran; oleh karena itu, itu harus diatur ke string yang didukung oleh Encoding kelas , jika tidak Save(String) gagal. Jika ini adalah null atau String.Empty, Save metode tidak menulis atribut pengodean pada deklarasi XML dan oleh karena itu pengodean default, UTF-8, digunakan.

Catatan: Jika XmlDocument disimpan ke TextWriter atau XmlTextWriter, nilai pengodean ini akan dibuang. Sebaliknya, pengodean TextWriter atau XmlTextWriter digunakan. Ini memastikan bahwa XML yang ditulis dapat dibaca kembali menggunakan pengodean yang benar.

standalone

String

Nilainya harus "ya" atau "tidak". Jika ini adalah null atau String.Empty, Save metode tidak menulis atribut mandiri pada deklarasi XML.

Mengembalikan

XmlDeclaration

Simpul baru XmlDeclaration .

Pengecualian

ArgumentException

Nilai version atau standalone adalah sesuatu selain yang ditentukan di atas.

Contoh

Contoh berikut membuat deklarasi XML dan menambahkannya ke dokumen.

#using <System.Xml.dll>

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

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

Keterangan

Atribut diekspos sebagai properti khusus pada simpul XmlDeclaration , dan bukan sebagai XmlAttribute simpul.

Meskipun metode ini membuat objek baru dalam konteks dokumen, metode ini tidak secara otomatis menambahkan objek baru ke pohon dokumen. Untuk menambahkan objek baru, Anda harus secara eksplisit memanggil salah satu metode penyisipan simpul.

Menurut rekomendasi W3C Extensible Markup Language (XML) 1.0, simpul XmlDeclaration harus menjadi simpul pertama dalam dokumen.

Metode ini adalah ekstensi Microsoft ke Model Objek Dokumen (DOM).

Lihat juga

• XmlDeclaration