<textMessageEncoding>
Especifica a codificação de carateres e o controlo de versões de mensagens utilizados para mensagens XML baseadas em texto.
<configuração>
<system.serviceModel>
<enlaces>
<customBinding>
<enlace>
<textMessageEncoding>
Syntax
<textMessageEncoding maxReadPoolSize="Integer"
maxWritePoolSize="Integer"
messageVersion="Soap11Addressing10/Soap12Addressing10"
writeEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding" />
Atributos e Elementos
As secções seguintes descrevem atributos, elementos subordinados e elementos principais.
Atributos
Atributo | Descrição |
---|---|
maxReadPoolSize | Um número inteiro que especifica quantas mensagens podem ser lidas em simultâneo sem alocar novos leitores. Os tamanhos de conjunto maiores tornam o sistema mais tolerante a picos de atividade ao custo de um conjunto de trabalho maior. A predefinição é 64. |
maxWritePoolSize | Um número inteiro que especifica quantas mensagens podem ser enviadas em simultâneo sem alocar novos escritores. Os tamanhos de conjunto maiores tornam o sistema mais tolerante a picos de atividade ao custo de um conjunto de trabalho maior. A predefinição é 16. |
messageVersion | Especifica a versão SOAP das mensagens enviadas com o enlace. Os valores válidos são - Soap11Addressing10 - Soap12Addressing10 - Soap11 - Soap12 A predefinição é Soap12Addressing10. Este atributo é do tipo MessageVersion. |
writeEncoding | Especifica a codificação do conjunto de carateres a utilizar para emitir mensagens no enlace. Os valores válidos são - UnicodeFffeTextEncoding: Codificação Unicode BigEndian - Utf16TextEncoding: codificação Unicode - Utf8TextEncoding: codificação de 8 bits A predefinição é Utf8TextEncoding. Este atributo é do tipo Encoding. |
Elementos Subordinados
Elemento | Descrição |
---|---|
<readerQuotas> | Define as restrições sobre a complexidade das mensagens SOAP que podem ser processadas por pontos finais configurados com este enlace. Este elemento é do tipo XmlDictionaryReaderQuotasElement. |
Elementos Principais
Elemento | Descrição |
---|---|
<enlace> | Define todas as capacidades de enlace do enlace personalizado. |
Observações
A codificação é o processo de transformação de uma mensagem numa sequência de bytes. A descodificação é o processo inverso. O Windows Communication Foundation (WCF) inclui três tipos de codificação para mensagens SOAP: Text, Binary and Message Transmission Optimization Mechanism (MTOM).
A codificação de texto representada pelo textMessageEncoding
elemento é a mais interoperável, mas o codificador menos eficiente para mensagens XML. O codificador de texto cria mensagens baseadas em texto no fio. As mensagens produzidas por este codificador são adequadas para interop baseado em WS*. Geralmente, o serviço Web ou o cliente do serviço Web podem compreender o XML textual. No entanto, transmitir grandes blocos de dados binários como texto é o método menos eficiente para codificar mensagens XML.
Exemplo
<textMessageEncoding maxReadPoolSize="211"
maxWritePoolSize="2132"
messageVersion="Soap12Addressing10"
textEncoding="utf-8" />