<textMessageEncoding>

Určuje kódování znaků a správu verzí zpráv používaných pro textové zprávy XML.

<Konfigurace>
  <System.servicemodel>
    <Vazby>
      <customBinding>
        <Vazba>
          <textMessageEncoding>

Syntax

<textMessageEncoding maxReadPoolSize="Integer"
                     maxWritePoolSize="Integer"
                     messageVersion="Soap11Addressing10/Soap12Addressing10"
                     writeEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding" />

Atributy a elementy

Následující části popisují atributy, podřízené prvky a nadřazené prvky.

Atributy

Atribut Popis
maxReadPoolSize Celé číslo, které určuje, kolik zpráv lze číst současně bez přidělení nových čtenářů. Větší velikosti fondů činí systém odolnějším vůči špičkám aktivity za cenu větší pracovní sady. Výchozí hodnota je 64.
maxWritePoolSize Celé číslo, které určuje, kolik zpráv lze odeslat současně bez přidělení nových zapisovačů. Větší velikosti fondů činí systém odolnějším vůči špičkám aktivity za cenu větší pracovní sady. Výchozí hodnota je 16.
Messageversion Určuje verzi protokolu SOAP zpráv odesílaných pomocí vazby. Platné hodnoty jsou

- Soap11Addressing10
- Soap12Addressing10
- Mýdlo11
- Mýdlo12

Výchozí hodnota je Soap12Addressing10. Tento atribut je typu MessageVersion.
writeEncoding Určuje kódování znakové sady, které se má použít pro generování zpráv ve vazbě. Platné hodnoty jsou

- UnicodeFffeTextEncoding: Kódování Unicode BigEndian
- Utf16TextEncoding: Kódování Unicode
- Utf8TextEncoding: 8bitové kódování

Výchozí hodnota je Utf8TextEncoding. Tento atribut je typu Encoding.

Podřízené elementy

Element Popis
<readerQuotas> Definuje omezení složitosti zpráv SOAP, které mohou být zpracovány koncovými body nakonfigurovanými pomocí této vazby. Tento prvek je typu XmlDictionaryReaderQuotasElement.

Nadřazené elementy

Element Popis
<Vazba> Definuje všechny možnosti vazby vlastní vazby.

Poznámky

Kódování je proces transformace zprávy na sekvenci bajtů. Dekódování je opačný proces. Windows Communication Foundation (WCF) obsahuje tři typy kódování pro zprávy SOAP: Text, Binary a Message Transmission Optimization Mechanism (MTOM).

Kódování textu reprezentované elementem textMessageEncoding je nejvíce interoperabilní, ale nejméně efektivní kodér pro zprávy XML. Textový kodér vytvoří textové zprávy na drátu. Zprávy vytvořené tímto kodérem jsou vhodné pro zprostředkovatele založené na WS*. Webová služba nebo klient webové služby obecně rozumí textovému xml. Přenos velkých bloků binárních dat jako textu je však nejméně efektivní metodou kódování zpráv XML.

Příklad

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

Viz také