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

  • Başvuru

Tanım

Ad Alanı:
System.Xml
Bütünleştirilmiş Kodlar:
System.Xml.dll, System.Xml.XmlDocument.dll
Bütünleştirilmiş Kod:
System.Xml.ReaderWriter.dll
Bütünleştirilmiş Kod:
System.Xml.XmlDocument.dll
Bütünleştirilmiş Kod:
System.Xml.dll
Bütünleştirilmiş Kod:
netstandard.dll

Belirtilen değerlere sahip 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);
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, 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

ArgumentException

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.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

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.