Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.

Tradução

Original

Este tópico ainda não foi avaliado como - Avalie este tópico

Método XmlWriter.WriteSurrogateCharEntity

.NET Framework 4.5

Outras versões

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

Namespace: System.Xml
Assembly: System.Xml (em System.Xml.dll)

Sintaxe

C++

public abstract void WriteSurrogateCharEntity(
	char lowChar,
	char highChar
)

Parâmetros

lowChar: Tipo: System.Char
Substituto baixo. Isso deve ser um valor entre 0xDC00 e 0xDFFF.

highChar: Tipo: System.Char
O substituto alto. Isso deve ser um valor entre 0xD800 e 0xDBFF.

Exceções

Exceção	Condição
ArgumentException	Um par de caractere substituto inválido foi passado.
InvalidOperationException	Um XmlWriter o método foi chamado antes da conclusão de uma operação assíncrona anterior. Nesse caso, InvalidOperationException é lançada com a mensagem "uma operação assíncrona já está em andamento."

Comentários

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

A entidade de caractere substituto é gravada em formato hexadecimal. O intervalo de caracteres substitutos é # x 10000 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 de caractere numérico) se baseia na UCS [ISO-10646]. Uma referência de caractere numérico em um documento de origem, portanto, talvez em alguns casos correspondem a duas unidades de 16 bits em uma seqüência de caracteres (um substituto alto e um substituto baixo). Essas unidades de 16 bits são chamadas de um par substituto.

Para obter mais informações sobre substitutos ou caracteres, consulte a seção 3.7 do Unicode standard 3.0/Unicode 2.0 localizado em http://www.unicode.org ou seção 2.2 a recomendação do W3C XML 1.0 localizado em http://www.w3.org/TR/REC-xml#charsets.

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

Informações sobre versão

.NET Framework

Com suporte em: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Biblioteca de Classes Portátil

Com suporte em: Biblioteca de Classes Portátil

.NET para aplicativos da Windows Store

Com suporte em: Windows 8

Plataformas

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte .Requisitos de sistema do NET Framework.

Consulte também

Referência

XmlWriter Classe

Namespace System.Xml

Outros recursos

Writing XML with the XmlWriter

Isso foi útil para você? Sim Não

Impreciso

Sem profundidade suficiente

Mais exemplos de código são necessários

A tradução precisa ser aprimorada

(1500 caracteres restantes)

Contribuições da comunidade

ADICIONAR

A Microsoft está realizando uma pesquisa online para saber sua opinião sobre o site do MSDN. Se você optar por participar, a pesquisa online lhe será apresentada quando você sair do site do MSDN.

Deseja participar?

Politica de Privacidade