Freigeben über

<mtomMessageEncoding>

Gibt die Codierungs- und Nachrichtenversionsverwaltung an, die für MTOM-basierte Nachrichten (SOAP Message Transmission Optimization Mechanism) verwendet wird.

<Konfiguration>
   <system.serviceModel>
     <Einbände>
       <Custombinding>
         <verbindlich>
           <mtomMessageEncoding>

Syntax

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

Attribute und Elemente

In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.

Attribute

Merkmal Description
maxBufferSize Eine ganze Zahl, die die maximale Größe des Puffers angibt, der verwendet werden kann.
maxReadPoolSize Eine ganze Zahl, die angibt, wie viele Nachrichten gleichzeitig gelesen werden können, ohne neue Leser zuzuweisen. Größere Poolgrößen machen das System toleranter für Aktivitätsspitzen zu Kosten eines größeren Arbeitssatzes. Der Standardwert ist 64.
maxWritePoolSize Eine ganze Zahl, die angibt, wie viele Nachrichten gleichzeitig gesendet werden können, ohne neue Autoren zuzuweisen. Größere Poolgrößen machen das System toleranter für Aktivitätsspitzen zu Kosten eines größeren Arbeitssatzes. Der Standardwert ist 16.
messageVersion Gibt die SOAP-Version der mit der Bindung gesendeten Nachrichten an. Gültige Werte sind

- Soap11Addressing1
- Soap12Addressing10

Der Standardwert ist Soap12Addressing10. Dieses Attribut ist vom Typ MessageVersion.
writeEncoding Gibt die Zeichensatzcodierung an, die für das Senden von Nachrichten in der Bindung verwendet werden soll. Gültige Werte sind

- UnicodeFffeTextEncoding: Unicode BigEndian-Codierung
- Utf16TextEncoding: Unicode-Codierung
- Utf8TextEncoding: 8-Bit-Codierung

Der Standardwert ist Utf8TextEncoding. Dieses Attribut ist vom Typ Encoding.

Untergeordnete Elemente

Element Description
<readerQuotas> Definiert die Einschränkungen für die Komplexität von SOAP-Nachrichten, die von Endpunkten verarbeitet werden können, die mit dieser Bindung konfiguriert sind. Dieses Element ist vom Typ XmlDictionaryReaderQuotasElement.

Übergeordnete Elemente

Element Description
<verbindlich> Definiert alle Bindungsfunktionen der benutzerdefinierten Bindung.

Bemerkungen

Die Codierung ist der Prozess der Transformation einer Nachricht in eine Folge von Bytes. Die Decodierung ist der umgekehrte Prozess. Windows Communication Foundation (WCF) enthält drei Arten von Codierung für SOAP-Nachrichten: Text, Binary and Message Transmission Optimization Mechanism (MTOM).

Das MtomMessageEncoding Element gibt die Zeichencodierung und Nachrichtenversionsverwaltung und andere Einstellungen an, die für Nachrichten mit einer MTOM-Codierung (Message Transmission Optimization Mechanism) verwendet werden. MTOM ist eine effiziente Technologie zum Übertragen von Binärdaten in WCF-Nachrichten. Der MTOM-Encoder versucht, ein Gleichgewicht zwischen Effizienz und Interoperabilität zu schaffen. Die MTOM-Codierung überträgt die meisten XML-Daten in Textform, optimiert jedoch große Blöcke von Binärdaten, indem sie as-isübertragen, ohne in ihr base64-codiertes Format zu konvertieren.

Example

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

Siehe auch

  • Last updated on