Compartilhar via

<textMessageEncoding>

Especifica a codificação de caracteres e o controle de versão da mensagem usados para mensagens XML baseadas em texto.

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

Sintaxe

<textMessageEncoding maxReadPoolSize="Integer"
                     maxWritePoolSize="Integer"
                     messageVersion="Soap11Addressing10/Soap12Addressing10"
                     writeEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding" />

Atributos e elementos

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

Attributes

Attribute Description
maxReadPoolSize Um inteiro que especifica quantas mensagens podem ser lidas simultaneamente sem alocar novos leitores. Tamanhos de pool maiores tornam o sistema mais tolerante aos 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 aos picos de atividade ao custo de um conjunto de trabalho maior. O padrão é 16.
messageVersion Especifica a versão SOAP das mensagens enviadas usando a associação. Valores válidos são

- Soap11Addressing10
- Soap12Addressing10
- Soap11
- Soap12

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. 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 Description
<Readerquotas> Define as restrições sobre a complexidade das mensagens SOAP que podem ser processadas por pontos de extremidade configurados com essa associação. Esse elemento é do tipo XmlDictionaryReaderQuotasElement.

Elementos pai

Elemento Description
<ligação> Define todos os recursos de associação da associação personalizada.

Observações

A codificação é o processo de transformação de uma mensagem em uma 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: Mecanismo de Otimização de Transmissão de Mensagens, Binário e Binário (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 esse codificador são adequadas para interoperabilidade baseada em WS*. O serviço Web ou o cliente de serviço Web geralmente pode entender XML textual. No entanto, transmitir grandes blocos de dados binários como texto é o método menos eficiente para codificar mensagens XML.

Example

<textMessageEncoding maxReadPoolSize="211"
                     maxWritePoolSize="2132"
                     messageVersion="Soap12Addressing10"
                     textEncoding="utf-8" />

Consulte também

  • Last updated on