<textMessageEncoding>
Spécifie l'encodage de caractères et le suivi des versions de message utilisés pour les messages XML textuels.
<configuration>
<system.serviceModel>
<liaisons>
<customBinding>
<liaison>
<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.
Attributs
| Attribut | Description |
|---|---|
| maxReadPoolSize | Entier qui spécifie combien de messages peuvent être lus de manière simultanée sans allouer de nouveaux lecteurs. Des pools plus volumineux permettent au système d'être 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. Des pools plus volumineux permettent au système d'être 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 les suivantes : - Soap11Addressing10 - Soap12Addressing10 - Soap11 - Soap12 La valeur par défaut est Soap12Addressing10. Cet attribut est de type MessageVersion. |
| writeEncoding | Spécifie l'encodage de jeu de caractères à utiliser pour l'émission de messages sur la liaison. Les valeurs valides sont les suivantes : - UnicodeFffeTextEncoding : encodage Unicode BigEndian - 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 | Description |
|---|---|
| <readerQuotas> | Définit les contraintes sur la complexité des messages SOAP pouvant ê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 d’une liaison personnalisée. |
Notes
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) inclut trois types d'encodage des messages SOAP : Texte, Binaire et MTOM (Message Transmission Optimization Mechanism).
L'encodage de texte représenté par l'élément textMessageEncoding est l'encodeur le plus interopérable, mais le moins efficace pour les messages XML. L'encodeur de texte crée des messages textuels sur le câble. Les messages produits par cet encodeur sont adaptés à l'interopérabilité basée sur WS-*. Les services Web ou les clients de ces services comprennent généralement le XML textuel. Toutefois, la transmission de grands blocs de données binaires sous forme de texte est la méthode d'encodage de messages XML la moins efficace.
Exemple
<textMessageEncoding maxReadPoolSize="211"
maxWritePoolSize="2132"
messageVersion="Soap12Addressing10"
textEncoding="utf-8" />
