Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

XmlTextWriter.WriteDocType méthode (String, String, String, String)

 

Date de publication : novembre 2016

Écrit la déclaration DOCTYPE avec le nom et les attributs facultatifs spécifiés.

Espace de noms:   System.Xml
Assembly:  System.Xml (dans System.Xml.dll)

public override void WriteDocType(
	string name,
	string pubid,
	string sysid,
	string subset
)

Paramètres

name
Type: System.String

Nom de DOCTYPE. Ne doit pas être vide.

pubid
Type: System.String

Si non null elle écrit également PUBLIC « pubid » « sysid », pubid et sysid sont remplacés par la valeur des arguments spécifiés.

sysid
Type: System.String

Si pubid a la valeur null et sysid est non null, elle écrit SYSTEM « sysid », sysid est remplacé par la valeur de cet argument.

subset
Type: System.String

Si la valeur est non null, elle écrit [subset] où subset est remplacé par la valeur de cet argument.

Exception Condition
InvalidOperationException

Cette méthode a été appelée en dehors du prologue (après l’élément racine).

ArgumentException

name est null ou String.Empty

ou

la valeur de name entraînerait un XML non valide.

System_CAPS_noteRemarque

À compter de .NET Framework 2.0, nous vous recommandons de créer XmlWriter instances à l’aide de la XmlWriter.Create méthode et la XmlWriterSettings classe pour tirer parti des nouvelles fonctionnalités.

Cette méthode ne vérifie pas les caractères non valides dans pubid, sysid ou subset. Il ne vérifie pas plus que le sous-ensemble interne est correctement construit.

System_CAPS_security Sécurité Remarque

Le XmlTextWriter ne valide pas les données qui sont transmises à la WriteDocType (méthode). Vous ne devez pas passer des données arbitraires à cette méthode.

L’exemple suivant écrit un fichier XML représentant un livre.

using System;
using System.IO;
using System.Xml;

public class Sample
{
  private const string filename = "sampledata.xml";

  public static void Main()
  {
     XmlTextWriter writer = null;

     writer = new XmlTextWriter (filename, null);
     //Use indenting for readability.
     writer.Formatting = Formatting.Indented;

     //Write the XML delcaration. 
     writer.WriteStartDocument();

     //Write the ProcessingInstruction node.
     String PItext="type='text/xsl' href='book.xsl'";
     writer.WriteProcessingInstruction("xml-stylesheet", PItext);

     //Write the DocumentType node.
     writer.WriteDocType("book", null , null, "<!ENTITY h 'hardcover'>");

     //Write a Comment node.
     writer.WriteComment("sample XML");

     //Write a root element.
     writer.WriteStartElement("book");

     //Write the genre attribute.
     writer.WriteAttributeString("genre", "novel");

     //Write the ISBN attribute.
     writer.WriteAttributeString("ISBN", "1-8630-014");

     //Write the title.
     writer.WriteElementString("title", "The Handmaid's Tale");

     //Write the style element.
     writer.WriteStartElement("style");
     writer.WriteEntityRef("h");
     writer.WriteEndElement(); 

     //Write the price.
     writer.WriteElementString("price", "19.95");

     //Write CDATA.
     writer.WriteCData("Prices 15% off!!");

     //Write the close tag for the root element.
     writer.WriteEndElement();

     writer.WriteEndDocument();

     //Write the XML to file and close the writer.
     writer.Flush();
     writer.Close();  

     //Load the file into an XmlDocument to ensure well formed XML.
     XmlDocument doc = new XmlDocument();
     //Preserve white space for readability.
     doc.PreserveWhitespace = true;
     //Load the file.
     doc.Load(filename);  

     //Display the XML content to the console.
     Console.Write(doc.InnerXml);  

  }

}

.NET Framework
Disponible depuis 1.1
Retour au début
Afficher: