Delen via


<mtomMessageEncoding>

Hiermee geeft u de codering en berichtversiebeheer die worden gebruikt voor soap message transmission optimization-berichten (MTOM) op basis van berichten.

<Configuratie>
  <system.serviceModel>
    <Bindings>
      <customBinding>
        <Bindend>
          <mtomMessageEncoding>

Syntax

<mtomMessageEncoding maxBufferSize="Integer"
                     maxReadPoolSize="Integer"
                     maxWritePoolSize="Integer"
                     messageVersion="Soap11Addressing1/Soap12Addressing10"
                     writeEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding" />

Kenmerken en elementen

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

Kenmerken

Kenmerk Beschrijving
Maxbuffersize Een geheel getal dat de maximale grootte aangeeft van de buffer die kan worden gebruikt.
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 activiteitspieken ten koste van een grotere werkset. De standaardwaarde is 64.
maxWritePoolSize Een geheel getal dat aangeeft hoeveel berichten tegelijkertijd kunnen worden verzonden zonder nieuwe schrijvers toe te wijzen. Grotere poolgrootten maken het systeem toleranter voor activiteitspieken ten koste van een grotere werkset. De standaardwaarde is 16.
messageVersion Hiermee geeft u de SOAP-versie van de berichten verzonden met behulp van de binding. Geldige waarden zijn

- Soap11Addressing1
- Soap12Addressing10

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.

Onderliggende elementen

Element Beschrijving
<lezerQuota's> 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

Element Beschrijving
<Bindend> Definieert alle bindingsmogelijkheden van de aangepaste binding.

Opmerkingen

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

Het MtomMessageEncoding -element specificeert de tekencodering en berichtversiebeheer en andere instellingen die worden gebruikt voor berichten met behulp van een MTOM-codering (Message Transmission Optimization Mechanisme). MTOM is een efficiƫnte technologie voor het verzenden van binaire gegevens in WCF-berichten. De MTOM-encoder probeert een balans te vinden tussen efficiƫntie en interoperabiliteit. De MTOM-codering verzendt de meeste XML in tekstvorm, maar optimaliseert grote blokken binaire gegevens door ze ongewijzigd te verzenden, zonder conversie naar de met base64 gecodeerde indeling.

Voorbeeld

<mtomMessageEncoding maxReadPoolSize="211"
                     maxWritePoolSize="2132"
                     messageVersion="Soap11Addressing10"
                     textEncoding="utf-8" />

Zie ook