XmlTextWriter.WriteSurrogateCharEntity(Char, Char) Método

Definición

Espacio de nombres:

System.Xml

Ensamblado:

System.Xml.ReaderWriter.dll

Ensamblado:

System.Xml.dll

Ensamblado:

netstandard.dll

Genera y escribe la entidad de carácter suplente del par de caracteres suplentes.

public:
 override void WriteSurrogateCharEntity(char lowChar, char highChar);

public override void WriteSurrogateCharEntity (char lowChar, char highChar);

override this.WriteSurrogateCharEntity : char * char -> unit

Public Overrides 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

Exception

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

Comentarios

Nota

A partir de la .NET Framework 2.0, se recomienda crear XmlWriter instancias mediante el XmlWriter.Create método y la XmlWriterSettings clase para aprovechar las nuevas funcionalidades.

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 es #x10000 para #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 de la recomendación Unicode 3.0/Unicode 2.0 o la sección 2.2 de la recomendación W3C XML 1.0.