XmlWriter.WriteSurrogateCharEntity(Char, Char) Método

Definição

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Quando substituído em uma classe derivada, gera e grava a entidade de caracteres alternativos para o par de caracteres alternativos.

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. Este deve ser um valor entre 0xDC00 e 0xDFFF.

highChar

Char

A alternativa alta. Este deve ser um valor entre 0xD800 e 0xDBFF.

Exceções

ArgumentException

Um par de caracteres alternativos inválido foi passado.

InvalidOperationException

Um método XmlWriter foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.

Comentários

Esse método só é aplicável em sistemas que usam codificação UTF-16.

A entidade de caractere substituto é escrita no formato hexadecimal. O intervalo para caracteres substitutos é #x10000 para #x10FFFF. A fórmula a seguir é usada para gerar a entidade de caractere substituto: (highChar -0xD800) * 0x400 + (lowChar -0xDC00) + 0x10000

Para HTML e XML, o conjunto de caracteres do documento (e, portanto, a notação de referências numéricas de caracteres) baseia-se no UCS [ISO-10646]. Uma única referência de caractere numérico em um documento de origem pode, portanto, em alguns casos corresponder a duas unidades de 16 bits em uma cadeia de caracteres (um substituto alto e um substituto baixo). Essas unidades de 16 bits são conhecidas como um par substituto.

Para obter mais informações sobre substitutos ou caracteres, consulte a seção 3.7 do padrão Unicode 3.0/Unicode 2.0 localizado na https://www.unicode.orgseção 2.2 da Recomendação W3C XML 1.0.

Para obter a versão assíncrona deste método, consulte WriteSurrogateCharEntityAsync.