XmlDocument.CreateDocumentType(String, String, String, String) Metod

Definition

Namnområde:
System.Xml
Sammansättningar:
netstandard.dll, System.Xml.ReaderWriter.dll
Sammansättning:
System.Xml.ReaderWriter.dll
Sammansättning:
System.Xml.dll
Sammansättning:
netstandard.dll
Källa:
XmlDocument.cs
Källa:
XmlDocument.cs
Källa:
XmlDocument.cs
Källa:
XmlDocument.cs
Källa:
XmlDocument.cs

Returnerar ett nytt XmlDocumentType objekt.

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

Parametrar

name
String

Namnet på dokumenttypen.

publicId
String

Den offentliga identifieraren för dokumenttypen eller null. Du kan ange en offentlig URI och även en systemidentifierare för att identifiera platsen för den externa DTD-delmängden.

systemId
String

Systemidentifieraren för dokumenttypen eller null. Anger URL:en för filplatsen för den externa DTD-delmängden.

internalSubset
String

Den interna DTD-delmängden av dokumenttypen eller null.

Returer

XmlDocumentType

Den nya XmlDocumentType.

Exempel

I följande exempel skapas en DocumentType-nod och läggs till i ett XML-dokument.

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

Kommentarer

Den returnerade noden har parsat Entities och Notations samlingar.

Även om den här metoden skapar det nya objektet i dokumentets kontext, lägger det inte automatiskt till det nya objektet i dokumentträdet. Om du vill lägga till det nya objektet måste du uttryckligen anropa någon av nodinfogningsmetoderna.

Enligt rekommendationen W3C Extensible Markup Language (XML) 1.0 tillåts DocumentType-noder endast i dokumentnoder. Var och XmlDocument en kan bara ha en DocumentType-nod. DocumentType-noden måste också infogas före rotelementet i XmlDocument (om dokumentet redan har ett rotelement kan du inte lägga till en DocumentType-nod). Om de överförda parametrarna inte kombineras för att skapa ett giltigt XmlDocumentTypegenereras ett undantag.

Anteckningar till arvingar

Den här metoden har en arvsefterfrågan. Fullständigt förtroende krävs för att åsidosätta CreateDocumentType metoden.

Den här metoden är ett Microsoft-tillägg till dokumentobjektmodellen (DOM).

Gäller för