XmlWriter.WriteSurrogateCharEntity(Char, Char) Método

Definição

Quando substituído em uma classe derivada, gera e grava a entidade de caracteres alternativos para o par de caracteres alternativos.When overridden in a derived class, generates and writes the surrogate character entity for the surrogate character pair.

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

A alternativa baixa.The low surrogate. Este deve ser um valor entre 0xDC00 e 0xDFFF.This must be a value between 0xDC00 and 0xDFFF.

highChar
Char

A alternativa alta.The high surrogate. Este deve ser um valor entre 0xD800 e 0xDBFF.This must be a value between 0xD800 and 0xDBFF.

Exceções

Um par de caracteres alternativos inválido foi passado.An invalid surrogate character pair was passed.

Um método XmlWriter foi chamado antes do término de uma operação assíncrona anterior.An XmlWriter method was called before a previous asynchronous operation finished. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Comentários

Esse método só é aplicável em sistemas que usam codificação UTF-16.This method is only applicable on systems that use UTF-16 encoding.

A entidade de caractere substituto é escrita em formato hexadecimal.The surrogate character entity is written in hexadecimal format. O intervalo de caracteres substitutos é #x10000 para #x10FFFF.The range for surrogate characters is #x10000 to #x10FFFF. A fórmula a seguir é usada para gerar a entidade de caractere substituta: ( highChar -0xD800) * 0x400 + ( lowChar -0xDC00) + 0x10000The following formula is used to generate the surrogate character entity: (highChar -0xD800) * 0x400 + (lowChar -0xDC00) + 0x10000

Para HTML e XML, o conjunto de caracteres do documento (e, portanto, a notação de referências de caracteres numéricos) baseia-se no UCS [ISO-10646].For both HTML and XML, the document character set (and therefore the notation of numeric character references) is based on UCS [ISO-10646]. Uma única referência de caractere numérico em um documento de origem pode, portanto, em alguns casos corresponder às unidades de 2 16 bits em uma cadeia de caracteres (um substituto alto e um baixo).A single numeric character reference in a source document may therefore in some cases correspond to two 16-bit units in a string (a high surrogate and a low surrogate). Essas unidades de 16 bits são chamadas de par substituto.These 16-bit units are referred to as a surrogate pair.

Para obter mais informações sobre substitutos ou caracteres, consulte a seção 3,7 do Unicode 3.0/Unicode 2,0 standard localizado em https://www.unicode.org ou a seção 2,2 da recomendação do W3C XML 1,0.For more information regarding surrogates or characters, refer to section 3.7 of the Unicode 3.0/Unicode 2.0 standard located at https://www.unicode.org, or section 2.2 of the W3C XML 1.0 Recommendation.

Para obter a versão assíncrona desse método, consulte WriteSurrogateCharEntityAsync .For the asynchronous version of this method, see WriteSurrogateCharEntityAsync.

Aplica-se a