Partager via

<textMessageEncoding>

Spécifie l’encodage de caractères et le contrôle de version des messages utilisés pour les messages XML textuels.

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

Syntaxe

<textMessageEncoding maxReadPoolSize="Integer"
                     maxWritePoolSize="Integer"
                     messageVersion="Soap11Addressing10/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
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

- Soap11Addressing10
- Soap12Addressing10
- Soap11
- Soap12

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’encodage de texte représenté par l’élément textMessageEncoding est le plus interopérable, mais l’encodeur le moins efficace pour les messages XML. L’encodeur de texte crée des messages textuels sur le câble. Les messages générés par cet encodeur conviennent à l’interopérabilité basée sur WS*. Le service web ou le client de service web peut généralement comprendre du code XML textuel. Toutefois, la transmission de grands blocs de données binaires en tant que texte est la méthode la moins efficace pour l’encodage des messages XML.

Example

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

Voir aussi

  • Last updated on