<textMessageEncoding>

Artikel
02/27/2011

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

Schemahierarchie

<<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, untergeordnete Elemente sowie übergeordnete Elemente beschrieben.

Attribute

Attribut	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 größeren 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 größeren Workingsets. Der Standardwert ist 16.
messageVersion	Gibt die SOAP-Version der Nachrichten an, die mithilfe der Bindung gesendet werden. Gültige Werte sind: Soap11Addressing10 Soap12Addressing10 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. 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	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 Bindungsfähigkeiten der benutzerdefinierten Bindung.

Hinweise

Beim Codieren wird eine Nachricht in eine Bytefolge transformiert. Beim Decodieren wird dieser Vorgang 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” />

Siehe auch

Freigeben über