XmlDocument.CreateDocumentType(String, String, String, String) Método

Definição

Namespace:

System.Xml

Assemblies:

netstandard.dll, System.Xml.ReaderWriter.dll

Origem:

XmlDocument.cs

Retorna um novo objeto 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

Parâmetros

name

String

O nome do tipo de documento.

publicId

String

O identificador público do tipo de documento ou null. É possível especificar um URI público e também um identificador do sistema para identificar o local do subconjunto de DTD externo.

systemId

String

O identificador do sistema do tipo de documento ou null. Especifica a URL do local do arquivo para o subconjunto de DTD externo.

internalSubset

String

O subconjunto de DTD interno do tipo de documento ou null.

Retornos

XmlDocumentType

O novo XmlDocumentType.

Exemplos

O exemplo a seguir cria um nó DocumentType e o adiciona a um documento XML.

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

Comentários

O nó retornado terá coleções e Notations analisadasEntities.

Embora esse método crie o novo objeto no contexto do documento, ele não adiciona automaticamente o novo objeto à árvore de documentos. Para adicionar o novo objeto, você deve chamar explicitamente um dos métodos de inserção de nó.

De acordo com a recomendação do W3C Extensible Markup Language (XML) 1.0, nós DocumentType só são permitidos em nós de documento. Cada XmlDocument um pode ter apenas um nó DocumentType. O nó DocumentType também deve ser inserido antes do elemento raiz do XmlDocument (se o documento já tiver um elemento raiz, você não poderá adicionar um nó DocumentType). Se os parâmetros passados não forem combinados para criar um válido XmlDocumentType, uma exceção será gerada.

Notas aos Herdeiros

Esse método tem uma demanda de herança. A confiança total é necessária para substituir o CreateDocumentType método .

Esse método é uma extensão da Microsoft para o DOM (Modelo de Objeto de Documento).