Compartir a través de

<textMessageEncoding>

  • Artículo

Especifica la codificación de caracteres y la versión del mensaje utilizadas para los mensajes XML basados en texto.

<<system.serviceModel>>
  <enlaces>
    <customBinding>
      <enlace>
        <textMessageEncoding>

<textMessageEncoding maxReadPoolSize="Integer"
   maxWritePoolSize="Integer"
   messageVersion="Soap11Addressing1/Soap12Addressing1"
      writeEncoding=”UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding" />

Atributos y elementos

Atributos

Atributo Descripción

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 puntos finales configurados con este enlace. Este elemento es del tipo XmlDictionaryReaderQuotasElement.

Elementos primarios

Elemento Descripción

<enlace>

Define todas las funciones de enlace del enlace personalizado.

Comentarios

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

La codificación de texto representada por el elemento textMessageEncoding es el codificador más interoperable, pero el menos eficaz para los mensajes XML. El codificador de texto crea mensajes basados en texto en la conexión. Los mensajes generados por este codificador son adecuados para la interoperabilidad basada en WS - *. Un servicio web o un cliente de servicios web, por lo general, pueden entender XML textual. Sin embargo, transmitir bloques grandes de datos binarios como texto es el método menos eficaz para codificar mensajes XML.

Ejemplo

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

Consulte también

Referencia

<customBinding>
TextMessageEncodingElement
CustomBinding
MessageEncodingBindingElement
TextMessageEncodingBindingElement

Conceptos

Codificación de mensajes

Otros recursos

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