Compartir vía


XmlWriter.WriteSurrogateCharEntity(Char, Char) Método

Definición

Cuando se invalida en una clase derivada, genera y escribe la entidad de carácter suplente para el par de caracteres suplentes.

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)

Parámetros

lowChar
Char

Suplente bajo. Debe ser un valor comprendido entre 0xDC00 y 0xDFFF.

highChar
Char

Suplente alto. Debe ser un valor comprendido entre 0xD800 y 0xDBFF.

Excepciones

Se ha pasado un par de caracteres suplentes no válido.

Se llamó un método XmlWriter antes de que se termine una operación asincrónica anterior. En este caso, se genera InvalidOperationException con el mensaje “Ya hay una operación asincrónica en curso”.

Comentarios

Este método solo es aplicable en sistemas que usan codificación UTF-16.

La entidad de caracteres suplentes se escribe en formato hexadecimal. El intervalo de caracteres suplentes se #x10000 a #x10FFFF. La fórmula siguiente se usa para generar la entidad de caracteres suplentes: (highChar -0xD800) * 0x400 + (lowChar -0xDC00) + 0x10000

Para HTML y XML, el juego de caracteres de documento (y, por tanto, la notación de referencias de caracteres numéricos) se basa en UCS [ISO-10646]. Por lo tanto, una sola referencia de caracteres numéricos en un documento de origen puede corresponder en algunos casos a dos unidades de 16 bits en una cadena (un suplente alto y un suplente bajo). Estas unidades de 16 bits se conocen como un par suplente.

Para obtener más información sobre los suplentes o caracteres, consulte la sección 3.7 del estándar Unicode 3.0/Unicode 2.0 ubicado en https://www.unicode.org, o la sección 2.2 de la recomendación W3C XML 1.0.

Para obtener la versión asincrónica de este método, vea WriteSurrogateCharEntityAsync.

Se aplica a