Freigeben über


XmlDocument.CreateDocumentType-Methode

Gibt ein neues XmlDocumentType-Objekt zurück.

Namespace: System.Xml
Assembly: System.Xml (in system.xml.dll)

Syntax

'Declaration
Public Overridable Function CreateDocumentType ( _
    name As String, _
    publicId As String, _
    systemId As String, _
    internalSubset As String _
) As XmlDocumentType
'Usage
Dim instance As XmlDocument
Dim name As String
Dim publicId As String
Dim systemId As String
Dim internalSubset As String
Dim returnValue As XmlDocumentType

returnValue = instance.CreateDocumentType(name, publicId, systemId, internalSubset)
public virtual XmlDocumentType CreateDocumentType (
    string name,
    string publicId,
    string systemId,
    string internalSubset
)
public:
virtual XmlDocumentType^ CreateDocumentType (
    String^ name, 
    String^ publicId, 
    String^ systemId, 
    String^ internalSubset
)
public XmlDocumentType CreateDocumentType (
    String name, 
    String publicId, 
    String systemId, 
    String internalSubset
)
public function CreateDocumentType (
    name : String, 
    publicId : String, 
    systemId : String, 
    internalSubset : String
) : XmlDocumentType

Parameter

  • name
    Der Name des Dokumenttyps.
  • publicId
    Der öffentliche Bezeichner des Dokumenttyps oder NULL (Nothing in Visual Basic). Sie können einen öffentlichen URI ebenso wie einen Systembezeichner angeben, um den Speicherort der externen DTD-Teilmenge zu identifizieren.
  • systemId
    Der Systembezeichner des Dokumenttyps oder NULL (Nothing in Visual Basic). Gibt den URL des Dateispeicherorts für die externe DTD-Teilmenge an.
  • internalSubset
    Die interne DTD-Teilmenge für den Dokumenttyp oder NULL (Nothing in Visual Basic).

Rückgabewert

Der neue XmlDocumentType.

Hinweise

Der zurückgegebene Knoten verfügt über eine analysierte Entities-Auflistung und eine analysierte Notations-Auflistung.

Obwohl diese Methode das neue Objekt im Kontext des Dokuments erstellt, wird es nicht automatisch der Dokumentstruktur hinzugefügt. Rufen Sie eine der Methoden zum Einfügen von Knoten explizit auf, um das neue Objekt hinzuzufügen.

Entsprechend der W3C-Empfehlung Extensible Markup Language (XML) 1.0 (www.w3.org/TR/1998/REC-xml-19980210, nur auf Englisch verfügbar) sind DocumentType-Knoten nur in Document-Knoten zulässig. Jedes XmlDocument kann über nur einen DocumentType-Knoten verfügen. Außerdem muss der DocumentType-Knoten vor dem Stammelement des XmlDocument eingefügt werden. (Wenn das Dokument jedoch bereits über ein Stammelement verfügt, können Sie keinen DocumentType-Knoten hinzufügen.)

Wenn die übergebenen Parameter keinen gültigen XmlDocumentType ergeben, wird eine Ausnahme ausgelöst.

Hinweise für Erben Diese Methode besitzt eine Vererbungsforderung. Zum Überschreiben der CreateDocumentType-Methode ist vollständige Vertrauenswürdigkeit erforderlich. Weitere Informationen finden Sie unter Vererbungsforderungen. Diese Methode ist eine Microsoft-Erweiterung des Dokumentobjektmodells (Document Object Model, DOM).

Beispiel

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

Option Explicit
Option Strict

Imports System
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 'Main
End Class 'Sample
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);
  }
}
#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 );
}
import System.*;
import System.IO.*;
import System.Xml.*;

public class Sample
{
    public static void main(String[] args)
    {
        //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.get_Out());
    } //main
} //Sample

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

XmlDocument-Klasse
XmlDocument-Member
System.Xml-Namespace