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

 

Date de publication : novembre 2016

En cas de substitution dans une classe dérivée, écrit le texte spécifié.

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

public abstract void WriteString(
	string text
)

Paramètres

text
Type: System.String

Texte à écrire.

Exception Condition
ArgumentException

La chaîne de texte contient une paire de substitution non 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. »

WriteString effectue les actions suivantes :

  • Les caractères &, <, et > sont remplacées par &amp;, &lt;, et &gt;, respectivement.

  • Le comportement par défaut d’un XmlWriter créé à l’aide Create consiste à lever une ArgumentException lorsque vous tentez d’écrire des valeurs de caractère dans le x-0x1F comprise entre 0 (à l’exclusion des espaces blancs 0 x 9, 0xA et 0xD). Ces caractères XML non valides peuvent être écrits en créant le XmlWriter avec la CheckCharacters propriété false. Cela entraîne les caractères sont remplacés par des entités de caractères numériques (&#0 ; à & #0x1F). En outre, un XmlTextWriter créé avec le new opérateur remplace les caractères non valides par des entités de caractère numérique par défaut.

Remarque   Microsoft n’encourage pas l’écriture caractères XML non valides, car de nombreuses applications qui consomment du XML ne sont pas conçues pour gérer des caractères non valides.

  • Si WriteString est appelée dans le contexte d’une valeur d’attribut, les guillemets doubles et simples sont remplacées par &quot; et &apos; respectivement.

Par exemple, cette chaîne d’entrée test<item>test est écrit sous la forme

test&lt;item&gt;test

Si text est null ou String.Empty, cette méthode écrit un nœud de texte ne contenant aucune donnée.

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

L’exemple suivant écrit un nœud XML.

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

public class Sample {

  public static void Main() {

     // Create a writer to write XML to the console.
     XmlWriterSettings settings = new XmlWriterSettings();
     settings.Indent = true;
     settings.OmitXmlDeclaration = true;
     XmlWriter writer = XmlWriter.Create(Console.Out, settings);

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

     // Write the title element.
     writer.WriteStartElement("title");
     writer.WriteString("Pride And Prejudice");
     writer.WriteEndElement();

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

     // Write the XML and close the writer.
     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: