Partager via

<mtomMessageEncoding>

Spécifie le codage et le contrôle de version des messages utilisés pour les messages MTOM (SOAP Message Transmission Optimization Mechanism).

<Configuration>
   <system.serviceModel>
     <Liaisons>
       <customBinding>
         <reliure>
           <mtomMessageEncoding>

Syntaxe

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

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributes

Caractéristique Descriptif
maxBufferSize Entier qui spécifie la taille maximale de la mémoire tampon qui peut être utilisée.
maxReadPoolSize Entier qui spécifie le nombre de messages pouvant être lus simultanément sans allouer de nouveaux lecteurs. Les tailles de pool plus grandes rendent le système plus tolérant aux pics d’activité au coût d’un ensemble de travail plus grand. La valeur par défaut est 64.
maxWritePoolSize Entier qui spécifie le nombre de messages pouvant être envoyés simultanément sans allouer de nouveaux enregistreurs. Les tailles de pool plus grandes rendent le système plus tolérant aux pics d’activité au coût d’un ensemble de travail plus grand. 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 l’encodage du jeu de caractères à utiliser pour émettre des messages sur la liaison. Les valeurs valides sont

- UnicodeFffeTextEncoding : encodage BigEndian Unicode
- Utf16TextEncoding : encodage Unicode
- Utf8TextEncoding : encodage 8 bits

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

Éléments enfants

Élément Descriptif
<readerQuotas> Définit les contraintes relatives à 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 Descriptif
<reliure> Définit toutes les fonctionnalités de liaison de la liaison personnalisée.

Remarques

L’encodage est le processus de transformation d’un message en une séquence d’octets. Le décodage est le processus inverse. Windows Communication Foundation (WCF) comprend trois types d’encodage pour les messages SOAP : MTOM (Text, Binary and Message Transmission Optimization Mechanism).

L’élément MtomMessageEncoding spécifie l’encodage de caractères et le contrôle de version des messages et d’autres paramètres utilisés pour les messages à l’aide d’un encodage MTOM (Message Transmission Optimization Mechanism). MTOM est une technologie efficace pour transmettre des données binaires dans des messages WCF. L’encodeur MTOM tente de créer un équilibre entre efficacité et interopérabilité. L’encodage MTOM transmet la plupart des données XML sous forme textuelle, mais optimise les grands blocs de données binaires en les transmettant as-is, sans conversion au format codé en base64.

Example

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

Voir aussi

  • Last updated on