<textMessageEncoding>

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

<configuration>
  <system.serviceModel>
    <bindings>
      <customBinding>
        <binding>
          <textMessageEncoding>

Syntaxe

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

Atributy a prvky

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

Attributes

Vlastnost Description
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ší 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ší vůči špičkám aktivity za cenu větší pracovní sady. Výchozí hodnota je 16.
verze zprávy Určuje verzi protokolu SOAP odeslaných zpráv pomocí vazby. Platné hodnoty jsou

- Soap11Addressing10
- Soap12Addressing10
- Soap11
- Soap12

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é prvky

prvek Description
<readerQuotas> Definuje omezení složitosti zpráv SOAP, které lze zpracovat koncovými body nakonfigurovanými touto vazbou. Tento prvek je typu XmlDictionaryReaderQuotasElement.

Nadřazené prvky

prvek Description
<závazný> Definuje všechny možnosti vazby vlastní vazby.

Poznámky

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

Kódování textu reprezentované elementem textMessageEncoding je nejoperabilní, ale nejméně efektivní kodér pro zprávy XML. Kodér textu vytvoří na drátě textové zprávy. Zprávy vytvořené tímto kodérem jsou vhodné pro interoperabilitu založenou na WS-*. Klient webové služby nebo webové služby obecně rozumí textovému kódu 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.

Example

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

Viz také