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

Definition

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Quelle:

XmlDocument.cs

Gibt ein neues XmlDocumentType-Objekt zurück.

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

Der Name des Dokumenttyps.

publicId

String

Der öffentliche Bezeichner des Dokumenttyps oder null. Sie können einen öffentlichen URI ebenso wie einen Systembezeichner angeben, um den Speicherort der externen DTD-Teilmenge zu identifizieren.

systemId

String

Der Systembezeichner des Dokumenttyps oder null. Gibt die URL des Dateispeicherorts für die externe DTD-Teilmenge an.

internalSubset

String

Die interne DTD-Teilmenge für den Dokumenttyp oder null.

Gibt zurück

XmlDocumentType

Die neue XmlDocumentType.

Beispiele

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

#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

Hinweise

Der zurückgegebene Knoten verfügt über analysierte Entities Und Notations -Auflistungen.

Obwohl diese Methode das neue Objekt im Kontext des Dokuments erstellt, fügt sie das neue Objekt nicht automatisch der Dokumentstruktur hinzu. Um das neue Objekt hinzuzufügen, müssen Sie explizit eine der Knoteneinfügemethoden aufrufen.

Gemäß der W3C Extensible Markup Language (XML) 1.0-Empfehlung sind DocumentType-Knoten nur innerhalb von Dokumentknoten zulässig. Jeder XmlDocument kann nur einen DocumentType-Knoten haben. Der Knoten DocumentType muss auch vor dem Stammelement des XmlDocument 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 eines gültigen XmlDocumentTypeParameters kombiniert werden, wird eine Ausnahme ausgelöst.

Hinweise für Vererber

Diese Methode hat eine Vererbungsanforderung. Um die Methode außer Kraft zu setzen, ist vollständige CreateDocumentType Vertrauenswürdigstellung erforderlich.

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