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.WriteStartDocument méthode ()

 

Date de publication : novembre 2016

Écrit la déclaration XML avec la version "1.0".

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

public override void WriteStartDocument()

Exception Condition
InvalidOperationException

Cela n’est pas la première méthode d’écriture appelée après le constructeur.

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.

Le niveau d’encodage du document est déterminé par le mode d’implémentation du writer. Par exemple, si un Encoding objet est spécifié dans le XmlTextWriter constructeur, ce paramètre détermine la valeur de l’attribut d’encodage. Cette méthode ne crée pas d’attribut autonome.

Lorsque WriteStartDocument est appelé le writer valide que vous écrivez est un document XML bien formé. Par exemple, il vérifie que la déclaration XML est le premier nœud, qu’un et un seul élément de niveau racine et ainsi de suite. Si cette méthode n’est pas appelée, le writer suppose qu’un fragment XML est écrit et n’applique aucune règle de niveau racine.

Si WriteStartDocument a été appelée, puis la WriteProcessingInstruction méthode est utilisée pour créer une autre déclaration XML, une exception est levée.

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: