XmlWriter.WriteSurrogateCharEntity(Char, Char) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 -> unitPublic 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.