Delen via


<textMessageEncoding>

Hiermee geeft u de tekencodering en berichtversiebeheer die wordt gebruikt voor op tekst gebaseerde XML-berichten.

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

Syntaxis

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

Kenmerken en elementen

In de volgende secties worden kenmerken, onderliggende elementen en bovenliggende elementen beschreven.

Attributes

Attribute Description
maxReadPoolSize Een geheel getal dat aangeeft hoeveel berichten tegelijkertijd kunnen worden gelezen zonder nieuwe lezers toe te wijzen. Grotere poolgrootten maken het systeem toleranter voor activiteitpieken ten koste van een grotere werkset. De standaardwaarde is 64.
maxWritePoolSize Een geheel getal dat aangeeft hoeveel berichten tegelijk kunnen worden verzonden zonder nieuwe schrijvers toe te wijzen. Grotere poolgrootten maken het systeem toleranter voor activiteitpieken ten koste van een grotere werkset. De standaardwaarde is 16.
messageVersion Hiermee geeft u de SOAP-versie van de berichten die worden verzonden met behulp van de binding. Geldige waarden zijn

- Soap11Addressing10
- Soap12Addressing10
- Soap11
- Soap12

De standaardwaarde is Soap12Addressing10. Dit kenmerk is van het type MessageVersion.
writeEncoding Hiermee geeft u de tekensetcodering die moet worden gebruikt voor het verzenden van berichten op de binding. Geldige waarden zijn

- UnicodeFffeTextEncoding: Unicode BigEndian-codering
- Utf16TextEncoding: Unicode-codering
- Utf8TextEncoding: 8-bits codering

De standaardwaarde is Utf8TextEncoding. Dit kenmerk is van het type Encoding.

Kind-elementen

Onderdeel Description
<readerQuotas> Definieert de beperkingen voor de complexiteit van SOAP-berichten die kunnen worden verwerkt door eindpunten die met deze binding zijn geconfigureerd. Dit element is van het type XmlDictionaryReaderQuotasElement.

Bovenliggende elementen

Onderdeel Description
<bindend> Definieert alle bindingsmogelijkheden van de aangepaste binding.

Opmerkingen

Encoding is het proces van het transformeren van een bericht in een reeks bytes. Decodering is het omgekeerde proces. Windows Communication Foundation (WCF) bevat drie typen codering voor SOAP-berichten: Text, Binary and Message Transmission Optimization Mechanism (MTOM).

De tekstcodering die door het textMessageEncoding element wordt vertegenwoordigd, is de meest interoperabele, maar de minst efficiƫnte encoder voor XML-berichten. Met de tekstcoderingsprogramma worden berichten op basis van tekst op de kabel gemaakt. Berichten die door deze encoder worden geproduceerd, zijn geschikt voor op WS*gebaseerde interoperabiliteit. Webservice of webserviceclient kan over het algemeen tekstuele XML begrijpen. Het verzenden van grote blokken binaire gegevens als tekst is echter de minst efficiƫnte methode voor het coderen van XML-berichten.

Example

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

Zie ook