Compartir a través de

<webMessageEncoding>

Permite que las codificaciones de mensajes XML de texto sin formato, notación de objetos JavaScript (JSON) y contenido binario "sin procesar" se lean y escriban cuando se usan en un enlace de Windows Communication Foundation (WCF).

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

Syntax

<webMessageEncoding maxReadPoolSize="Integer"
                    maxWritePoolSize="Integer"
                    writeEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding" />

Atributos y elementos

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

Attributes

Atributo Description
maxReadPoolSize Cantidad de mensajes que se pueden leer simultáneamente sin asignar nuevos lectores. Los tamaños de grupo más grandes hacen que el sistema sea más tolerante a los picos de actividad a costa de un conjunto de trabajo mayor. El valor predeterminado es 64 lectores para cada uno de los codificadores internos (texto, JSON y "sin formato").

Aumentar este número aumenta el consumo de memoria, pero prepara el codificador para tratar con ráfagas repentinas de mensajes entrantes porque es capaz de usar lectores del grupo que ya se han creado en lugar de crear otros nuevos.
maxWritePoolSize Cantidad de mensajes que se pueden enviar simultáneamente sin asignar nuevos escritores. Los tamaños de grupo más grandes hacen que el sistema sea más tolerante a los picos de actividad a costa de un conjunto de trabajo mayor. El valor predeterminado es 16 escritores para cada uno de los codificadores internos (texto, JSON y "sin formato").

Aumentar este número aumenta el consumo de memoria, pero prepara el codificador para tratar con ráfagas repentinas de mensajes salientes porque es capaz de usar escritores del grupo que ya se han creado en lugar de crear otros nuevos.
writeEncoding Especifica la codificación del juego de caracteres que se va a usar para emitir mensajes en el enlace. Los valores válidos son:

- UnicodeFffeTextEncoding: codificación Big Endian unicode.
- Utf16TextEncoding: codificación Unicode.
- Utf8TextEncoding: codificación de 8 bits.

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

Elementos secundarios

Elemento Description
<readerQuotas> Define las restricciones sobre la complejidad de los mensajes SOAP que los puntos de conexión configurados con este enlace pueden procesar. Este elemento es de tipo XmlDictionaryReaderQuotasElement.

Elementos primarios

Elemento Description
<encuadernación> Define todas las funcionalidades de enlace del enlace personalizado.

Observaciones

La codificación es el proceso de transformar un mensaje en una secuencia de bytes. La descodificación es el proceso inverso. Estos procesos requieren la especificación de una codificación de caracteres.

El webMessageEncoding elemento funciona mediante la delegación en una serie de codificadores internos para controlar las codificaciones XML y JSON de texto sin formato y los datos binarios "sin procesar". Esta delegación se realiza mediante un codificador de mensajes compuestos.

Este elemento de enlace y su codificador compuesto se usan para controlar la codificación en escenarios que no usan la mensajería SOAP utilizada por el webHttpBinding elemento. Estos escenarios incluyen "XML antiguo sin formato" (POX), transferencia de estado representacional (REST), distribución realmente simple (RSS) y distribución atom, y JavaScript asincrónico y XML (AJAX). El codificador de mensajes compuestos no admite SOAP ni WS-Addressing.

El elemento de enlace se puede configurar con una codificación de caracteres de escritura mediante el writeEncoding atributo . El valor proporcionado Encoding especifica el comportamiento de escritura para los casos JSON y Textual XML. En lectura, se entiende cualquier codificación de mensajes válida y codificación de texto.

maxReadPoolSize y maxWritePoolSize también se pueden usar para establecer el número máximo de lectores y escritores que se asignarán respectivamente. De forma predeterminada, se asignan 64 lectores y 16 escritores.

Las restricciones de complejidad predeterminadas también se establecen mediante el <elemento readerQuotas> para protegerse frente a una clase de ataques por denegación de servicio (DOS) que intentan usar la complejidad del mensaje para vincular los recursos de procesamiento de puntos de conexión.

Example

<webMessageEncoding maxReadPoolSize="256"
                    maxWritePoolSize="128"
                    messageVersion="None"
                    textEncoding="utf-8" />

Consulte también

  • Last updated on