XmlTextWriter.WriteSurrogateCharEntity(Char, Char) Método

Definição

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Gera e grava a entidade de caracteres alternativos para o par de caracteres alternativos.

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

A alternativa baixa. Deve ser um valor entre 0xDC00 e 0xDFFF.

highChar

Char

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

Exceções

Exception

Um par de caracteres alternativos inválido foi passado.

Comentários

Observação

A partir do .NET Framework 2.0, recomendamos que você crie XmlWriter instâncias usando o XmlWriter.Create método e a XmlWriterSettings classe para aproveitar a nova funcionalidade.

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 ou a seção 2.2 da Recomendação W3C XML 1.0.