Metodo XmlDocument.CreateDocumentType

Il nodo restituito conterrà gli insiemi Entities e Notations analizzati.

Anche se mediante questo metodo il nuovo oggetto viene creato nel contesto del documento, tuttavia non viene aggiunto automaticamente alla struttura ad albero del documento. Per aggiungere il nuovo oggetto, è necessario chiamare in modo esplicito uno dei metodi di inserimento dei nodi.

In base alla raccomandazione W3C relativa a XML (Extensible Markup Language) 1.0, disponibile all'indirizzo www.w3.org/TR/1998/REC-xml-19980210 (informazioni in lingua inglese), i nodi DocumentType sono consentiti solo all'interno di nodi Document. Ciascun XmlDocument può contenere un unico nodo DocumentType. Inoltre il nodo DocumentType deve essere inserito prima dell'elemento di primo livello di XmlDocument. Se il documento ha già un elemento di primo livello, non è possibile aggiungere un nodo DocumentType.

Se i parametri passati non si combinano per compilare un XmlDocumentType valido, verrà generata un'eccezione.

Questo metodo ha una richiesta di ereditarietà. Per eseguire l'override del metodo CreateDocumentType, è necessario un livello di attendibilità totale. Per ulteriori informazioni, vedere Richieste di ereditarietà.

Questo metodo è un'estensione Microsoft del modello DOM (Document Object Model).

Nell'esempio seguente viene creato un nodo DocumentType e aggiunto a un 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);
  }
}

.NET Framework

.NET Framework Client Profile

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (ruoli di base del server non supportati), Windows Server 2008 R2 (ruoli di base del server supportati con SP1 o versione successiva, Itanium non supportato)

Riferimenti