XmlDocument.CreateXmlDeclaration(String, String, String) Yöntem

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Xml.ReaderWriter.dll

Kaynak:

XmlDocument.cs

Belirtilen değerlerle bir XmlDeclaration düğüm oluşturur.

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

Parametreler

version

String

Sürüm "1.0" olmalıdır.

encoding

String

Kodlama özniteliğinin değeri. Bu, öğesini bir dosyaya veya akışa kaydettiğinizde XmlDocument kullanılan kodlamadır; bu nedenle, sınıfı tarafından Encoding desteklenen bir dizeye ayarlanmalıdır, aksi takdirde Save(String) başarısız olur. Bu veya String.Empty ise null , Save yöntemi XML bildiriminde bir kodlama özniteliği yazmaz ve bu nedenle varsayılan kodlama olan UTF-8 kullanılır.

Not: veya öğesine XmlDocumentTextWriterkaydedilirseXmlTextWriter, bu kodlama değeri atılır. Bunun yerine veya TextWriter kodlaması XmlTextWriter kullanılır. Bu, yazılan XML'in doğru kodlama kullanılarak geri okunmasını sağlar.

standalone

String

Değer "evet" veya "hayır" olmalıdır. Bu null veya String.Empty ise, Save yöntemi XML bildiriminde tek başına bir öznitelik yazmaz.

Döndürülenler

XmlDeclaration

Yeni XmlDeclaration düğüm.

Özel durumlar

ArgumentException

veya version değerleristandalone, yukarıda belirtilen değerlerden başka bir değerdir.

Örnekler

Aşağıdaki örnek bir XML bildirimi oluşturur ve bunu belgeye ekler.

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

Açıklamalar

Öznitelikler düğüm olarak değil düğümde XmlDeclaration özel özellikler olarak XmlAttribute sunulur.

Bu yöntem yeni nesneyi belge bağlamında oluştursa da, yeni nesneyi belge ağacına otomatik olarak eklemez. Yeni nesneyi eklemek için düğüm ekleme yöntemlerinden birini açıkça çağırmanız gerekir.

W3C Genişletilebilir Biçimlendirme Dili (XML) 1.0 önerisineXmlDeclaration göre, düğüm belgedeki ilk düğüm olmalıdır.

Bu yöntem, Belge Nesne Modeli'nin (DOM) Microsoft bir uzantısıdır.

Ayrıca bkz.

• XmlDeclaration