Condividi tramite

<textMessageEncoding>

Specifica la codifica dei caratteri e il controllo delle versioni dei messaggi utilizzati per i messaggi XML basati su testo.

<configurazione>
   <system.serviceModel>
     <Associazioni>
       <Custombinding>
         <rilegatura>
           <textMessageEncoding>

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.

Attributes

Attribute Description
maxReadPoolSize Intero che specifica il numero di messaggi che possono essere letti simultaneamente senza allocare nuovi lettori. Le dimensioni del pool più grandi rendono il sistema più tollerante ai picchi di attività a costo di un working set più grande. Il valore predefinito è 64.
maxWritePoolSize Intero che specifica il numero di messaggi che possono essere inviati contemporaneamente senza allocare nuovi writer. Le dimensioni del pool più grandi rendono il sistema più tollerante ai picchi di attività a costo di un working set più grande. Il valore predefinito è 16.
messageVersion Specifica la versione SOAP dei messaggi inviati tramite l'associazione. I valori validi sono

- Soap11Addressing10
- Soap12Addressing10
- Soap11
- Soap12

Il valore predefinito è Soap12Addressing10. Questo attributo è di tipo MessageVersion.
writeEncoding Specifica la codifica del set di caratteri da utilizzare per l'emissione di messaggi nell'associazione. I valori validi sono

- UnicodeFffeTextEncoding: codifica Unicode BigEndian
- Utf16TextEncoding: codifica Unicode
- Utf8TextEncoding: codifica a 8 bit

Il valore predefinito è Utf8TextEncoding. Questo attributo è di tipo Encoding.

Elementi figli

Elemento Description
<readerQuotas> Definisce i vincoli sulla complessità dei messaggi SOAP che possono essere elaborati dagli endpoint configurati con questa associazione. Questo elemento è di tipo XmlDictionaryReaderQuotasElement.

Elementi padre

Elemento Description
<rilegatura> Definisce tutte le funzionalità di associazione dell'associazione personalizzata.

Osservazioni:

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: Text, Binary and Message Transmission Optimization Mechanism (MTOM).

La codifica del testo rappresentata dall'elemento textMessageEncoding è il codificatore più interoperabile, ma il codificatore meno efficiente per i messaggi XML. Il codificatore di testo crea messaggi basati su testo in transito. I messaggi prodotti da questo codificatore sono adatti per l'interoperabilità basata su WS*. Il servizio Web o il client del servizio Web può in genere comprendere il codice XML testuale. Tuttavia, la trasmissione di grandi blocchi di dati binari come testo è il metodo meno efficiente per la codifica dei messaggi XML.

Example

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

Vedere anche

  • Last updated on