<mtomMessageEncoding>

Especifica a codificação e o versionamento de mensagens usados para mensagens baseadas no Mecanismo de Otimização da Transmissão de Mensagens SOAP (MTOM).

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

Sintaxe

<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.

Attributes

Attribute Description
maxBufferSize Um inteiro que especifica o tamanho máximo do buffer que pode ser utilizado.
maxReadPoolSize Um inteiro que especifica quantas mensagens podem ser lidas simultaneamente sem alocar novos leitores. Grupos maiores tornam o sistema mais tolerante a picos de atividade, à custa de um conjunto de trabalho maior. O padrão é 64.
maxWritePoolSize Um inteiro que especifica quantas mensagens podem ser enviadas simultaneamente sem alocar novos escritores. Grupos maiores tornam o sistema mais tolerante a picos de atividade, à custa de um conjunto de trabalho maior. O padrão é 16.
messageVersion Especifica a versão SOAP das mensagens enviadas usando a ligação. Os valores válidos são

- Soap11Addressing1
- Soap12Addressing10

O padrão é Soap12Addressing10. Este atributo é do tipo MessageVersion.
writeEncoding Especifica a codificação do conjunto de caracteres a ser usada para emitir mensagens na ligaçã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. Este atributo é do tipo Encoding.

Elementos filho

Elemento Description
<LeitorQuotas> Define as restrições à complexidade das mensagens SOAP que podem ser processadas pelos endpoints configurados com esta ligação. Este elemento é do tipo XmlDictionaryReaderQuotasElement.

Elementos Principais

Elemento Description
<Encadernação> Define todas as capacidades de ligação da ligação personalizada.

Observações

A codificação é o processo de transformar uma mensagem numa sequência de bytes. A decodificação é o processo inverso. O Windows Communication Foundation (WCF) inclui três tipos de codificação para mensagens SOAP: Texto, Binário e Mecanismo de Otimização de Transmissão de Mensagens (MTOM).

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

Example

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

Consulte também