XmlTextWriter.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.
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 -> unitPublic 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
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.