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.WriteCharEntity méthode (Char)

 

Date de publication : novembre 2016

Force la génération d'une entité de caractère pour la valeur du caractère Unicode spécifiée.

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

public override void WriteCharEntity(
	char ch
)

Paramètres

ch
Type: System.Char

Caractère Unicode pour lequel une entité de caractère.

Exception Condition
ArgumentException

Le caractère se trouve dans la plage de caractères de paire de substitution, 0xd800 - 0xdfff; ou le texte entraînerait un document XML incorrect.

InvalidOperationException

WriteState a la valeur Closed.

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.

Cette méthode écrit le caractère Unicode dans un format de référence d’entité caractère hexadécimal.

L’exemple suivant utilise le WriteCharEntity méthode pour écrire une adresse de messagerie.

using System;
using System.Xml;

public class Sample {

  public static void Main() {

    XmlTextWriter writer = null;

      try {

        writer = new XmlTextWriter (Console.Out);

        // Write an element.
        writer.WriteStartElement("address");

        // Write an e-mail address using entities
        // for the @ and . characters.
        writer.WriteString("someone");
        writer.WriteCharEntity('@');
        writer.WriteString("example");
        writer.WriteCharEntity('.');
        writer.WriteString("com");
        writer.WriteEndElement();

    }        

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

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