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 reemplaza en una clase derivada, genera y escribe la entidad de caracteres suplentes 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 entre 0xDC00 y 0xDFFF.
- highChar
- Char
El suplente alto. Debe ser un valor entre 0xD800 y 0xDBFF.
Excepciones
Se pasó un par de caracteres suplentes no válido.
Se llamó a un XmlWriter método antes de que finalice una operación asincrónica anterior. En este caso, InvalidOperationException se produce con el mensaje "Una operación asincrónica ya está en curso".
Comentarios
Este método solo es aplicable a los 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 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.
