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, String)

 

Date de publication : novembre 2016

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

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

public void WriteAttributeString(
	string localName,
	string ns,
	string value
)

Paramètres

localName
Type: System.String

Le nom local de l'attribut.

ns
Type: System.String

URI de l'espace de noms à associer à 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. »

Cette méthode écrit l’attribut avec un préfixe d’espace de noms défini utilisateur et l’associe à l’espace de noms donné. Si localName est « xmlns », puis cette méthode l’interprète comme une déclaration d’espace de noms. Dans ce cas, le ns argument peut être null.

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 utilise le WriteAttributeString méthode pour écrire une déclaration d’espace de noms.

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

public class Sample {

  public static void Main() {

     XmlWriter writer = null;

     writer = XmlWriter.Create("sampledata.xml");

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

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

     // Write the bk:ISBN="1-800-925" attribute.
     writer.WriteAttributeString("ISBN", "urn:book", "1-800-925");

     writer.WriteElementString("price", "19.95");

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

     // Write the XML to file and close the writer.
     writer.Flush();
     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: