<textMessageEncoding>

Artigo
06/08/2023

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" />

Partilhar via