<textMessageEncoding>

Artikel
06/23/2023

Gibt die Zeichencodierung und die für textbasierte XML-Nachrichten verwendete Nachrichtenversionierung an.

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

Syntax

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

Attribute und Elemente

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

Attribute

attribute	BESCHREIBUNG
maxReadPoolSize	Eine ganze Zahl, die bestimmt, wie viele Nachrichten gleichzeitig gelesen werden können, ohne neue Leser zuzuordnen. Durch größere Poolgrößen wird das System toleranter gegenüber Aktivitätsspitzen auf Kosten eines umfangreicheren Workingsets. Der Standardwert ist 64.
maxWritePoolSize	Eine ganze Zahl, die bestimmt, wie viele Nachrichten gleichzeitig gesendet werden können, ohne neue Schreiber zuzuordnen. Durch größere Poolgrößen wird das System toleranter gegenüber Aktivitätsspitzen auf Kosten eines umfangreicheren Workingsets. Der Standardwert ist 16.
messageVersion	Gibt die SOAP-Version der Nachrichten an, die mithilfe der Bindung gesendet werden. Folgende Werte sind gültig: - Soap11Addressing10 – Soap12Addressing10 - Soap11 - Soap12 Der Standardwert ist Soap12Addressing10. Dieses Attribut ist vom Typ MessageVersion.
writeEncoding	Gibt die Zeichensatzcodierung an, die zum Ausgeben von Nachrichten über die Bindung verwendet werden soll. Folgende Werte sind gültig: – UnicodeFffeTextEncoding: Unicode-BigEndian-Codierung – Utf16TextEncoding: Unicode-Codierung – Utf8TextEncoding: 8-Bit-Codierung Der Standardwert ist Utf8TextEncoding. Dieses Attribut ist vom Typ Encoding.

Untergeordnete Elemente

Element	BESCHREIBUNG
<readerQuotas>	Definiert die Beschränkungen der Komplexität von SOAP-Nachrichten, die von Endpunkten verarbeitet werden können, die mit dieser Bindung konfiguriert wurden. Dieses Element ist vom Typ XmlDictionaryReaderQuotasElement.

Übergeordnete Elemente

Element	BESCHREIBUNG
<binding>	Definiert alle Bindungsmöglichkeiten der benutzerdefinierten Bindung.

Bemerkungen

Beim Codieren wird eine Nachricht in eine Bytefolge transformiert. Beim Decodieren wird dieser Prozess umgekehrt. Windows Communication Foundation (WCF) enthält drei Typen für die Codierung von SOAP-Nachrichten: Text, binär und Message Transmission Optimization Mechanism (MTOM).

Die vom textMessageEncoding-Element dargestellte Textcodierung ist am besten für die Interoperabilität geeignet, jedoch der am wenigsten effektive Encoder für XML-Nachrichten. Der Textencoder erstellt textbasierte Nachrichten. Von diesem Encoder erzeugte Nachrichten sind für die WS-*-basierte Interoperabilität geeignet. Der Webdienst oder Webdienstclient kann im Allgemeinen Text-XML verstehen. Das Übertragen großer Binärdatenblöcke als Text ist allerdings die am wenigsten effiziente Methode zum Verschlüsseln von XML-Meldungen.

Beispiel

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