<mtomMessageEncoding>

Especifica la codificación y la versión del mensaje utilizada para los mensajes basados en el mecanismo de optimización de la transmisión de mensajes (MTOM) SOAP.

Jerarquía del esquema

<<system.serviceModel>>
  <enlaces>
    <customBinding>
      <binding>
        <mtomMessageEncoding>

Sintaxis

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

Atributos y elementos

En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.

Atributos

Atributo Descripción

maxBufferSize

Un entero que especifica el tamaño máximo del búfer que se puede utilizar.

maxReadPoolSize

Un entero que especifica cuántos mensajes pueden leerse simultáneamente sin asignar nuevos lectores. Los tamaños de grupo más grandes hacen que el sistema sea más tolerante a picos de actividad a costa de un espacio de trabajo mayor. El valor predeterminado es 64.

maxWritePoolSize

Un entero que especifica cuántos mensajes pueden enviarse simultáneamente sin asignar nuevos escritores. Los tamaños de grupo más grandes hacen que el sistema sea más tolerante a picos de actividad a costa de un espacio de trabajo mayor. El valor predeterminado es 16.

messageVersion

Especifica la versión SOAP de los mensajes enviados utilizando el enlace. Los valores válidos son

  • Soap11Addressing1

  • Soap12Addressing10

El valor predeterminado es Soap12Addressing10. Este atributo es del tipo MessageVersion.

writeEncoding

Especifica el codificador del juego de caracteres que se va a usar para emitir los mensajes en el enlace. Los valores válidos son

  • UnicodeFffeTextEncoding: codificación de Unicode BigEndian

  • Utf16TextEncoding: Codificación Unicode

  • Utf8TextEncoding: codificación de 8 bits.

El valor predeterminado es Utf8TextEncoding. Este atributo es del tipo Encoding.

Elementos secundarios

Elemento Descripción

<readerQuotas>

Define restricciones en la complejidad de los mensajes SOAP que pueden ser procesados por los extremos configurados con este enlace. Este elemento es del tipo XmlDictionaryReaderQuotasElement.

Elementos primarios

Elemento Descripción

<binding>

Define todas las funciones de enlace del enlace personalizado.

Notas

Codificar es el proceso de transformar un mensaje en una secuencia de bytes. Descodificar es el proceso inverso. Windows Communication Foundation (WCF) incluye tres tipos de codificación para los mensajes SOAP: Texto, Binario y Mecanismo de optimización de transmisión del mensaje (MTOM).

El elemento MtomMessageEncoding especifica la codificación de caracteres y control de versión de mensajes y otros valores usados para los mensajes que utilizan una codificación MTOM (mecanismo de optimización de transmisión de mensajes). MTOM es una tecnología eficaz para la transmisión de datos binarios en mensajes de WCF. El codificador MTOM intenta crear una balanza entre la eficacia y la interoperabilidad. El codificador MTOM transmite la mayoría del XML en formato de texto, pero optimiza los bloques grandes de datos binarios transmitiéndolos como son, sin convertirlos a su formato codificado base64.

Ejemplo

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

Vea también

Referencia

<customBinding>
MtomMessageEncodingElement
CustomBinding
MessageEncodingBindingElement
MtomMessageEncodingBindingElement

Conceptos

Codificación de mensajes

Otros recursos

Choosing a Message Encoder
Windows Communication Foundation Bindings
Extending Bindings
Custom Bindings