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.WriteAttributeString méthode (String, String)

 

Date de publication : novembre 2016

En cas de substitution dans une classe dérivée, écrit l'attribut avec le nom local et la valeur spécifiés.

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

public void WriteAttributeString(
	string localName,
	string value
)

Paramètres

localName
Type: System.String

Le nom local de l'attribut.

value
Type: System.String

Valeur de l'attribut.

Exception Condition
InvalidOperationException

L’état du writer n’est pas WriteState.Element ou le writer est fermé.

ArgumentException

Le xml:space ou xml:lang valeur d’attribut n’est pas valide.

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. »

WriteAttributeString effectue les actions suivantes :

  • Si la valeur d’attribut inclut des guillemets doubles ou simples, ils sont remplacés par " et ' respectivement.

  • Si l’écriture d’un xml:space attribut, le writer vérifie que la valeur d’attribut est valide. (Les valeurs valides sont preserve ou default.)

  • Si l’écriture d’un xml:lang attribut, le writer ne vérifie pas si que la valeur d’attribut est valide conformément à la recommandation W3C XML 1.0.

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

L’exemple suivant écrit un livre.

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: