XmlWriter.WriteSurrogateCharEntity(Char, Char) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 -> unitPublic 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
Une paire de caractères de substitution non valide est passée.
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.