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 pour 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
Le substitut faible. Il doit s’agir d’une valeur comprise entre 0xDC00 et 0xDFFF.
- highChar
- Char
Le substitut élevé. Il doit s’agir d’une valeur comprise entre 0xD800 et 0xDBFF.
Exceptions
Une paire de caractères de substitution non valide a été passée.
Une XmlWriter méthode a été appelée avant la fin d’une opération asynchrone précédente. Dans ce cas, 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 à deux unités 16 bits dans une chaîne (une substitution élevée et une substitution faible). Ces unités 16 bits sont appelées paires 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.orgla section 2.2 de la recommandation W3C XML 1.0.
Pour obtenir la version asynchrone de cette méthode, consultez WriteSurrogateCharEntityAsync.
