Partager via

<mtomMessageEncoding>

  • Article

Spécifie le codage et le suivi des versions de message utilisés pour les messages basés sur MTOM (Message Transmission Optimization Mechanism).

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

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

Attributs et éléments

Attributs

Attribut Description

maxBufferSize

Entier qui spécifie la taille maximale de la mémoire tampon qui peut être utilisée.

maxReadPoolSize

Entier qui spécifie combien de messages peuvent être lus de manière simultanée sans allouer de nouveaux lecteurs. Avec des tailles de pool plus importantes, le système est plus tolérant aux pics d'activité au prix d'une plage de travail plus volumineuse. La valeur par défaut est 64.

maxWritePoolSize

Entier qui spécifie combien de messages peuvent être envoyés simultanément sans allouer de nouveaux enregistreurs. Avec des tailles de pool plus importantes, le système est plus tolérant aux pics d'activité au prix d'une plage de travail plus volumineuse. La valeur par défaut est 16.

messageVersion

Spécifie la version SOAP des messages envoyés à l'aide de la liaison. Les valeurs valides sont :

  • Soap11Addressing1
  • Soap12Addressing10

La valeur par défaut est Soap12Addressing10. Cet attribut est de type MessageVersion.

writeEncoding

Spécifie le codage de jeu de caractères à utiliser pour l'émission de messages sur la liaison. Les valeurs valides sont :

  • UnicodeFffeTextEncoding : codage Unicode Big Endian
  • Utf16TextEncoding : codage Unicode
  • Utf8TextEncoding : codage 8 bits

La valeur par défaut est Utf8TextEncoding. Cet attribut est de type Encoding.

Éléments enfants

Élément Description

<readerQuotas>

Définit les contraintes de la complexité des messages SOAP qui peuvent être traités par les points de terminaison configurés avec cette liaison. Cet élément est de type XmlDictionaryReaderQuotasElement.

Éléments parents

Élément Description

<binding>

Définit toutes les fonctions de liaison de la liaison personnalisée.

Notes

Le codage consiste en la transformation d'un message en une séquence d'octets. Le décodage est le processus inverse. Windows Communication Foundation (WCF) inclut trois types de codage des messages SOAP : Texte, Binaire et MTOM (Message Transmission Optimization Mechanism).

L'élément MtomMessageEncoding spécifie le codage de caractères et le contrôle de version de message, ainsi que d'autres paramètres utilisés pour un message codé avec MTOM (Message Transmission Optimization Mechanism). MTOM est une technologie efficace de transmission de données binaires dans les messages WCF. Le codeur MTOM tente de créer un équilibre entre rendement et interopérabilité. Le codage MTOM transmet la plupart des données XML sous forme textuelle, mais optimise les blocs de données binaires volumineux en les transmettant tels quels, sans conversion au format base64 codé.

Exemple

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

Voir aussi

Référence

<customBinding>
MtomMessageEncodingElement
CustomBinding
MessageEncodingBindingElement
MtomMessageEncodingBindingElement

Concepts

Codage de message

Autres ressources

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