XmlTextWriter.WriteSurrogateCharEntity(Char, Char) Méthode

Définition

Espace de noms:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Génère et écrit l'entité de caractère de substitution correspondant à la paire de caractères de substitution.

public:
 override void WriteSurrogateCharEntity(char lowChar, char highChar);

public override void WriteSurrogateCharEntity (char lowChar, char highChar);

override this.WriteSurrogateCharEntity : char * char -> unit

Public Overrides Sub WriteSurrogateCharEntity (lowChar As Char, highChar As Char)

Paramètres

lowChar

Char

Substitut faible. Il doit s'agir d'une valeur entre 0xDC00 et 0xDFFF.

highChar

Char

Substitut étendu. Il doit s'agir d'une valeur entre 0xD800 et 0xDBFF.

Exceptions

Exception

Une paire de caractères de substitution non valide est passée.

Remarques

Notes

À compter de la .NET Framework 2.0, nous vous recommandons de créer XmlWriter des instances à l’aide de la XmlWriter.Create méthode et de la XmlWriterSettings classe pour tirer parti de nouvelles fonctionnalités.

Cette méthode s’applique uniquement aux systèmes qui utilisent l’encodage UTF-16.

L’entité de caractère de substitution est écrite au format hexadécimal. La plage pour les caractères de substitution est #x10000 à #x10FFFF. La formule suivante est utilisée pour générer l’entité de caractère de substitution : (highChar - 0xD800) * + 0x400 () + ( - lowChar``0xDC00) + . 0x10000

Pour HTML et XML, le jeu de caractères de document (et par conséquent la notation des références de caractères numériques) est basé sur UCS [ISO-10646]. Une référence de caractère numérique unique dans un document source peut donc correspondre dans certains cas à deux unités 16 bits dans une chaîne (un substitut élevé et un substitut faible). Ces unités 16 bits sont appelées paire de substitution.

Pour plus d’informations sur les substituts ou les caractères, reportez-vous à la section 3.7 de la norme Unicode 3.0/Unicode 2.0 ou à la section 2.2 de la recommandation W3C XML 1.0.