<mtomMessageEncoding>

Representa a seção de configuração que especifica a codificação e o controle de versão de mensagem usados para mensagens baseadas em MTOM (Mecanismo de Otimização de Transmissão de Mensagem SOAP).

<configuration>
  <system.serviceModel>
    <bindings>
      <customBinding>
        <binding>
          <mtomMessageEncoding>

Syntax

<mtomMessageEncoding maxBufferSize="Integer"
                     maxReadPoolSize="Integer"
                     maxWritePoolSize="Integer"
                     messageVersion="Soap11Addressing1/Soap12Addressing10"
                     writeEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding" />

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho e elementos pai.

Atributos

Atributo Descrição
maxBufferSize Um inteiro que especifica o tamanho máximo do buffer que pode ser usado.
maxReadPoolSize Um número inteiro que especifica quantas mensagens podem ser lidas simultaneamente sem alocar novos leitores. Tamanhos de pool maiores tornam o sistema mais tolerante a picos de atividade ao custo de um conjunto de trabalho maior. O padrão é 64.
maxWritePoolSize Um inteiro que especifica quantas mensagens podem ser enviadas simultaneamente sem alocar novos gravadores. Tamanhos de pool maiores tornam o sistema mais tolerante a picos de atividade ao custo de um conjunto de trabalho maior. O padrão é 16.
messageVersion Especifica a versão SOAP das mensagens enviadas com a associação. Os valores válidos são

- Soap11Addressing1
- Soap12Addressing10

O padrão é Soap12Addressing10. Esse atributo é do tipo MessageVersion.
writeEncoding Especifica a codificação do conjunto de caracteres a ser usada para emitir mensagens na associação. Os valores válidos são

UnicodeFffeTextEncoding: codificação Unicode BigEndian
− Utf16TextEncoding: codificação Unicode
Utf8TextEncoding: codificação de 8 bits

O padrão é Utf8TextEncoding. Esse atributo é do tipo Encoding.

Elementos filho

Elemento Descrição
<readerQuotas> Define as restrições sobre a complexidade das mensagens SOAP que podem ser processadas pelos pontos de extremidade configurados com essa associação. Esse elemento é do tipo XmlDictionaryReaderQuotasElement.

Elementos pai

Elemento Descrição
<binding> Define todas as funcionalidades de associação da associação personalizada.

Comentários

Codificação é o processo de transformar uma mensagem em uma sequência de bytes. A decodificação é o processo inverso. O WCF (Windows Communication Foundation) inclui três tipos de codificação para mensagens SOAP: Mecanismo de otimização de transmissão de texto, binário e mensagem (MTOM).

O MtomMessageEncoding elemento especifica a codificação de caracteres e o controle de versão da mensagem e outras configurações usadas para mensagens usando uma codificação MTOM (Mecanismo de Otimização de Transmissão de Mensagens). O MTOM é uma tecnologia eficiente para transmitir dados binários em mensagens do WCF. O codificador MTOM tenta criar um equilíbrio entre eficiência e interoperabilidade. A codificação MTOM transmite a maioria dos XML em forma textual, mas otimiza grandes blocos de dados binários transmitindo-os como está, sem conversão em seu formato codificado em base64.

Exemplo

<mtomMessageEncoding maxReadPoolSize="211"
                     maxWritePoolSize="2132"
                     messageVersion="Soap11Addressing10"
                     textEncoding="utf-8" />

Confira também