<codificaMessaggiTesto>
Specifica le impostazioni di codifica e controllo di versione dei messaggi XML basati sul testo.
<Configurazione>
<system.serviceModel>
<Associazioni>
<Custombinding>
<Associazione>
<codificaMessaggiTesto>
Sintassi
<textMessageEncoding maxReadPoolSize="Integer"
maxWritePoolSize="Integer"
messageVersion="Soap11Addressing10/Soap12Addressing10"
writeEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding" />
Attributi ed elementi
Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.
Attributi
| Attributo | Descrizione |
|---|---|
| maxReadPoolSize | Numero intero che specifica il numero di messaggi che possono essere letti contemporaneamente senza allocare nuovi reader. Dimensioni maggiori del pool rendono il sistema più tollerante ai picchi di attività al costo di un working set superiore. Il valore predefinito è 64. |
| maxWritePoolSize | Numero intero che specifica il numero di messaggi che possono essere inviati contemporaneamente senza allocare nuovi writer. Dimensioni maggiori del pool rendono il sistema più tollerante ai picchi di attività al costo di un working set superiore. Il valore predefinito è 16. |
| messageVersion | Specifica la versione SOAP dei messaggi inviati usando l'associazione. I valori validi sono: - Soap11Addressing10 - Soap12Addressing10 - Soap11 - Soap12 L'impostazione predefinita è Soap12Addressing10. L'attributo è di tipo MessageVersion. |
| writeEncoding | Specifica la codifica del set di caratteri da usare per l'emissione dei messaggi dell'associazione. I valori validi sono: - UnicodeFffeTextEncoding: codifica BigEndian Unicode - Utf16TextEncoding: codifica Unicode - Utf8TextEncoding: codifica a 8 bit L'impostazione predefinita è Utf8TextEncoding. L'attributo è di tipo Encoding. |
Elementi figlio
| Elemento | Descrizione |
|---|---|
| <readerQuotas> | Definisce i vincoli sulla complessità dei messaggi SOAP che possono essere elaborati dagli endpoint configurati con questa associazione. L'elemento è di tipo XmlDictionaryReaderQuotasElement. |
Elementi padre
| Elemento | Descrizione |
|---|---|
| <Associazione> | Definisce tutte le funzionalità di associazione dell'associazione personalizzata. |
Commenti
La codifica è il processo di trasformazione di un messaggio in una sequenza di byte. La decodifica è il processo inverso. Windows Communication Foundation (WCF) include tre tipi di codifica per i messaggi SOAP, ovvero testo, binaria e MTOM (Message Transmission Optimization Mechanism).
La codifica di testo rappresentata dall'elemento textMessageEncoding è la più interoperativa, ma la meno efficiente per i messaggi XML. Il codificatore di testo crea messaggi in transito basati su testo. I messaggi prodotti da questo codificatore sono adatti per l'interoperabilità basata su WS-*. In genere il servizio Web o il client di tale servizio è in grado di comprendere codice XML in formato testo. Tuttavia, la trasmissione di grandi blocchi di dati binari come testo è il metodo meno efficiente per la codifica di messaggi XML.
Esempio
<textMessageEncoding maxReadPoolSize="211"
maxWritePoolSize="2132"
messageVersion="Soap12Addressing10"
textEncoding="utf-8" />
