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

 

Date de publication : novembre 2016

Écrit le texte spécifié.

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

public override 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.

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.

WriteString effectue les opérations suivantes

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

  • Les valeurs de caractère dans le x-0x1F comprise entre 0 (à l’exclusion des espaces blancs 0 x 9, 0xA et 0xD) sont remplacées par des entités de caractères numériques (&#0; via &#0x1F).

  • 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 en tant que

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.

L’exemple suivant écrit un fragment 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.
     XmlTextWriter writer = null;
     writer = new XmlTextWriter (Console.Out);

     //Use indentation for readability.
     writer.Formatting = Formatting.Indented;
     writer.Indentation = 4;

     //Write an element (this one is the root).
     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 to file and close the writer.
     writer.Close();  

  }

}

.NET Framework
Disponible depuis 1.1
Retour au début
Afficher: