İngilizce dilinde oku

Aracılığıyla paylaş


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

Tanım

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

public virtual System.Xml.XmlDeclaration CreateXmlDeclaration (string version, string encoding, string standalone);
public virtual System.Xml.XmlDeclaration CreateXmlDeclaration (string version, string? encoding, string? standalone);

Parametreler

version
String

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

encoding
String

Kodlama özniteliğinin değeri. Bu, 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 utf-8 varsayılan kodlaması kullanılır.

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

standalone
String

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

Döndürülenler

XmlDeclaration

Yeni XmlDeclaration düğüm.

Özel durumlar

veya standalone değerleriversion, yukarıda belirtilenlerden 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);
  }
}

Açıklamalar

Öznitelikler düğüm olarak değil düğümde XmlDeclaration özel özellikler olarak XmlAttribute kullanıma 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) Bir Microsoft uzantısıdır.

Şunlara uygulanır

Ayrıca bkz.