XmlWriter.WriteSurrogateCharEntity(Char, Char) Méthode

Définition

Espace de noms:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

En cas de substitution dans une classe dérivée, génère et écrit l'entité de caractère de substitution correspondant à la paire de caractères de substitution.

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

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

abstract member WriteSurrogateCharEntity : char * char -> unit

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

Paramètres

lowChar

Char

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

highChar

Char

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

Exceptions

ArgumentException

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

InvalidOperationException

Une méthode XmlWriter a été appelée avant la fin d’une opération asynchrone précédente. Dans ce cas, l’exception InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».

Remarques

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 des caractères de substitution est #x10000 à #x10FFFF. La formule suivante permet de 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 située à https://www.unicode.orgl’emplacement , ou à la section 2.2 de la recommandation W3C XML 1.0.

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