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

XmlWriter.WriteStartElement méthode (String, String, String)

 

Date de publication : novembre 2016

En cas de substitution dans une classe dérivée, écrit l’étiquette de début spécifiée, puis l’associe à l’espace de noms et au préfixe indiqués.

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

public abstract void WriteStartElement(
	string prefix,
	string localName,
	string ns
)

Paramètres

prefix
Type: System.String

Préfixe d'espace de noms de cet élément.

localName
Type: System.String

Le nom local de l'élément.

ns
Type: System.String

URI de l'espace de noms à associer à l'élément.

Exception Condition
InvalidOperationException

Le writer est fermé.

EncoderFallbackException

Il existe un caractère dans la mémoire tampon qui est un caractère XML valide mais n’est pas valide pour l’encodage de sortie. Par exemple, si l’encodage de sortie est ASCII, vous utilisez uniquement des caractères de la plage de 0 à 127 pour les noms d’élément et d’attribut. Le caractère non valide peut être dans l’argument de cette méthode ou dans un argument des méthodes précédentes qui écrivaient dans la mémoire tampon. Ces caractères sont ignorés par les références d’entité de caractère lorsque cela est possible (par exemple, dans les nœuds de texte ou les valeurs d’attribut). Toutefois, la référence d’entité de caractère n’est pas autorisée dans les noms d’éléments et d’attributs, commentaires, instructions de traitement ou les sections CDATA.

InvalidOperationException

Un XmlWriter méthode a été appelée avant la fin d'une opération asynchrone précédente. Dans ce cas, InvalidOperationException est levée avec le message « une opération asynchrone est déjà en cours. »

Pour obtenir la version asynchrone de cette méthode, consultez la page WriteStartElementAsync.

L’exemple suivant écrit un fragment XML.

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

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

   public static void Main() {

      XmlWriter writer = null;

      try {

        XmlWriterSettings settings = new XmlWriterSettings();
        settings.Indent = true;
        writer = XmlWriter.Create (m_Document, settings);

        writer.WriteComment("sample XML fragment");

        // Write an element (this one is the root).
        writer.WriteStartElement("book");

        // Write the namespace declaration.
        writer.WriteAttributeString("xmlns", "bk", null, "urn:samples");

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

        // Write the title.
        writer.WriteStartElement("title");
        writer.WriteString("The Handmaid's Tale");
        writer.WriteEndElement();

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

        // Lookup the prefix and write the ISBN element.
        string prefix = writer.LookupPrefix("urn:samples");
        writer.WriteStartElement(prefix, "ISBN", "urn:samples");
        writer.WriteString("1-861003-78");
        writer.WriteEndElement();

        // Write the style element (shows a different way to handle prefixes).
        writer.WriteElementString("style", "urn:samples", "hardcover");

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

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

      finally {
        if (writer != null)
           writer.Close();
     } 
   }

 }

Plateforme Windows universelle
Disponible depuis 8
.NET Framework
Disponible depuis 1.1
Bibliothèque de classes portable
Pris en charge dans : plateformes .NET portables
Silverlight
Disponible depuis 2.0
Silverlight pour Windows Phone
Disponible depuis 7.0
Windows Phone
Disponible depuis 8.1
Retour au début
Afficher: