XmlDocument.CreateDocumentType(String, String, String, String) Methode

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);

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

Gibt zurück

Das neue XmlDocumentType.

Beispiele

Im folgenden Beispiel wird ein DocumentType-Knoten erstellt und einem XML-Dokument hinzugefügt.

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

Hinweise

Der zurückgegebene Knoten hat analysiert Entities und Notations Auflistungen.

Obwohl diese Methode das neue Objekt im Kontext des Dokuments erstellt, wird das neue Objekt nicht automatisch der Dokumentstruktur hinzugefügt. Um das neue Objekt hinzuzufügen, müssen Sie explizit eine der Methoden zum Einfügen von Knoten aufrufen.

Gemäß der Empfehlung von W3C Extensible Markup Language (XML) 1.0 sind DocumentType-Knoten nur in Dokumentknoten zulässig. Jeder XmlDocument kann nur einen DocumentType-Knoten aufweisen. Der DocumentType-Knoten muss auch vor dem Stammelement des XmlDocument Dokuments eingefügt werden (wenn das Dokument bereits über ein Stammelement verfügt, können Sie keinen DocumentType-Knoten hinzufügen). Wenn die übergebenen Parameter nicht zum Erstellen einer gültigen XmlDocumentTypeParameter kombiniert werden, wird eine Ausnahme ausgelöst.

Hinweise für Vererber

Diese Methode hat eine Vererbungsnachfrage. Die vollständige Vertrauensstellung ist erforderlich, um die CreateDocumentType Methode außer Kraft zu setzen.

Diese Methode ist eine Microsoft-Erweiterung für das Document Object Model (DOM).