XmlDocument.CreateDocumentType(String, String, String, String) Metode

Definisi

Ruang nama:

System.Xml

Rakitan:

System.Xml.ReaderWriter.dll

Sumber:

XmlDocument.cs

Mengembalikan objek baru XmlDocumentType .

public:
 virtual System::Xml::XmlDocumentType ^ CreateDocumentType(System::String ^ name, System::String ^ publicId, System::String ^ systemId, System::String ^ internalSubset);

public virtual System.Xml.XmlDocumentType CreateDocumentType (string name, string? publicId, string? systemId, string? internalSubset);

abstract member CreateDocumentType : string * string * string * string -> System.Xml.XmlDocumentType
override this.CreateDocumentType : string * string * string * string -> System.Xml.XmlDocumentType

Public Overridable Function CreateDocumentType (name As String, publicId As String, systemId As String, internalSubset As String) As XmlDocumentType

Parameter

name

String

Nama jenis dokumen.

publicId

String

Pengidentifikasi publik jenis dokumen atau null. Anda dapat menentukan URI publik dan juga pengidentifikasi sistem untuk mengidentifikasi lokasi subset DTD eksternal.

systemId

String

Pengidentifikasi sistem dari jenis dokumen atau null. Menentukan URL lokasi file untuk subset DTD eksternal.

internalSubset

String

Subset internal DTD dari jenis dokumen atau null.

Mengembalikan

XmlDocumentType

Yang baru XmlDocumentType.

Contoh

Contoh berikut membuat simpul DocumentType dan menambahkannya ke dokumen XML.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   
   //Create the XmlDocument.
   XmlDocument^ doc = gcnew XmlDocument;
   
   //Create a document type node and  
   //add it to the document.
   XmlDocumentType^ doctype;
   doctype = doc->CreateDocumentType( "book", nullptr, nullptr, "<!ELEMENT book ANY>" );
   doc->AppendChild( doctype );
   
   //Create the root element and 
   //add it to the document.
   doc->AppendChild( doc->CreateElement( "book" ) );
   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()
  {
    //Create the XmlDocument.
    XmlDocument doc = new XmlDocument();

    //Create a document type node and
    //add it to the document.
    XmlDocumentType doctype;
    doctype = doc.CreateDocumentType("book", null, null, "<!ELEMENT book ANY>");
    doc.AppendChild(doctype);

    //Create the root element and
    //add it to the document.
    doc.AppendChild(doc.CreateElement("book"));

    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()
        'Create the XmlDocument.
        Dim doc As New XmlDocument()
        
        'Create a document type node and  
        'add it to the document.
        Dim doctype As XmlDocumentType
        doctype = doc.CreateDocumentType("book", Nothing, Nothing, "<!ELEMENT book ANY>")
        doc.AppendChild(doctype)
        
        'Create the root element and 
        'add it to the document.
        doc.AppendChild(doc.CreateElement("book"))
        
        Console.WriteLine("Display the modified XML...")
        doc.Save(Console.Out)
    End Sub
End Class

Keterangan

Simpul yang dikembalikan akan diurai Entities dan Notations koleksi.

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

Menurut rekomendasi W3C Extensible Markup Language (XML) 1.0, simpul DocumentType hanya diizinkan dalam simpul Dokumen. Masing-masing XmlDocument hanya dapat memiliki satu simpul DocumentType. Simpul DocumentType juga harus disisipkan sebelum elemen XmlDocument akar (jika dokumen sudah memiliki elemen akar, Anda tidak dapat menambahkan simpul DocumentType). Jika parameter yang diteruskan tidak digabungkan untuk membangun yang valid XmlDocumentType, pengecualian akan dilemparkan.

Catatan Bagi Inheritor

Metode ini memiliki permintaan warisan. Kepercayaan penuh diperlukan untuk mengambil CreateDocumentType alih metode .

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