XmlTextWriter.WriteSurrogateCharEntity(Char, Char) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Gera e escreve a entidade de carácter substituto para o par de caracteres substitutos.
public:
override void WriteSurrogateCharEntity(char lowChar, char highChar);public override void WriteSurrogateCharEntity(char lowChar, char highChar);override this.WriteSurrogateCharEntity : char * char -> unitPublic Overrides Sub WriteSurrogateCharEntity (lowChar As Char, highChar As Char)Parâmetros
- lowChar
- Char
A substituta baixa. Isto deve ser um valor entre 0xDC00 e 0xDFFF.
- highChar
- Char
A alta substituta. Isto deve ser um valor entre 0xD800 e 0xDBFF.
Exceções
Foi aprovado um par de personagens substitutos inválidos.
Observações
Note
Recomendamos que crie instâncias XmlWriter usando o método XmlWriter.Create e a classe XmlWriterSettings para aproveitar a nova funcionalidade.
Este método só é aplicável a sistemas que utilizam codificação UTF-16.
A entidade do carácter substituto é escrita em formato hexadecimal. O intervalo para caracteres substitutos é #x10000 para #x10FFFF. A seguinte fórmula é usada para gerar a entidade substituta: (highChar - 0xD800) * 0x400 + (lowChar - 0xDC00) + . 0x10000
Para HTML e XML, o conjunto de caracteres do documento (e, portanto, a notação das referências numéricas) baseia-se no UCS [ISO-10646]. Uma única referência numérica de carácter num documento fonte pode, portanto, em alguns casos corresponder a duas unidades de 16 bits numa cadeia (um substituto alto e um substituto baixo). Estas unidades de 16 bits são chamadas de par substituto.
Para mais informações sobre substitutos ou caracteres, consulte a secção 3.7 da norma Unicode 3.0/Unicode 2.0, ou a secção 2.2 da Recomendação XML 1.0 do W3C.
