Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

XmlWriter.WriteSurrogateCharEntity méthode (Char, Char)

 

Date de publication : novembre 2016

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.

Espace de noms:   System.Xml
Assembly:  System.Xml (dans System.Xml.dll)

public abstract void WriteSurrogateCharEntity(
	char lowChar,
	char highChar
)

Paramètres

lowChar
Type: System.Char

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

highChar
Type: System.Char

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

Exception Condition
ArgumentException

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

InvalidOperationException

Un 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. »

Cette méthode est uniquement applicable sur les systèmes qui utilisent l’encodage UTF-16.

L’entité de caractère de substitution est écrite au format hexadécimal. La plage de 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) * 0 x 400 + (lowChar -0xDC00) + 0 x 10000

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

Pour plus d’informations sur les substituts ou des caractères, consultez la section 3.7 de l’Unicode 3.0/Unicode 2.0 standard située à http://www.unicode.org, section 2.2 de la recommandation W3C XML 1.0 http://www.w3.org/TR/REC-xml#charsets.

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

Plateforme Windows universelle
Disponible depuis 8
.NET Framework
Disponible depuis 1.1
Bibliothèque de classes portable
Pris en charge dans : plateformes .NET portables
Silverlight
Disponible depuis 2.0
Silverlight pour Windows Phone
Disponible depuis 7.0
Windows Phone
Disponible depuis 8.1
Retour au début
Afficher: