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

Definição

Espaço de Nomes:
System.Xml
Assemblagem:
System.Xml.dll
Assemblagem:
netstandard.dll

Devolve um novo XmlDocumentType objeto.

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

Nome do tipo de documento.

publicId
String

O identificador público do tipo de documento ou null. Pode especificar um URI público e também um identificador de sistema para identificar a localização do subconjunto externo DTD.

systemId
String

O identificador do sistema do tipo de documento ou null. Especifica a URL da localização do ficheiro para o subconjunto DTD externo.

internalSubset
String

O subconjunto interno DTD do tipo de documento ou null.

Devoluções

XmlDocumentType

O novo XmlDocumentType.

Exemplos

O exemplo seguinte cria um nó DocumentType e adiciona-o 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

Observações

O nó devolvido terá as coleções Entities analisadas e Notations analisadas.

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

De acordo com a recomendação W3C Extensible Markup Language (XML) 1.0, os nós DocumentType só são permitidos dentro dos nós Document. Cada um XmlDocument 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, não pode adicionar um nó DocumentType). Se os parâmetros passados não se combinarem para construir um válido XmlDocumentType, é lançada uma exceção.

Notas para Herdeiros

Este método tem uma exigência de herança. É necessária total confiança para sobrepor o CreateDocumentType método.

Este método é uma extensão da Microsoft para o Document Object Model (DOM).

Aplica-se a