Partilhar via


<mtomMessageEncoding>

Especifica a codificação e o controlo de versões de mensagens utilizados para mensagens baseadas no Mecanismo de Otimização da Transmissão de Mensagens SOAP (MTOM).

<configuração>
  <system.serviceModel>
    <enlaces>
      <customBinding>
        <enlace>
          <mtomMessageEncoding>

Syntax

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

Atributos e Elementos

As secções seguintes descrevem atributos, elementos subordinados e elementos principais.

Atributos

Atributo Descrição
maxBufferSize Um número inteiro que especifica o tamanho máximo da memória intermédia que pode ser utilizada.
maxReadPoolSize Um número inteiro que especifica quantas mensagens podem ser lidas em simultâneo sem alocar novos leitores. 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. 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

- Soap11Addressing1
- Soap12Addressing10

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

O MtomMessageEncoding elemento especifica a codificação de carateres e o controlo de versões de mensagens e outras definições utilizadas para mensagens através de 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 tenta criar um equilíbrio entre a eficiência e a interoperabilidade. A codificação MTOM transmite a maioria do XML na forma textual, mas otimiza grandes blocos de dados binários ao transmiti-los tal como estão, sem conversão no formato codificado base64.

Exemplo

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

Veja também