Freigeben über

<textMessageEncoding>

Gibt die Zeichencodierung und Die Nachrichtenversionsverwaltung an, die für textbasierte XML-Nachrichten verwendet wird.

<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

Merkmal Description
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

- Soap11Addressing10
- Soap12Addressing10
- Soap11
- Soap12

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).

Die durch das textMessageEncoding Element dargestellte Textcodierung ist die interoperableste, aber der am wenigsten effiziente Encoder für XML-Nachrichten. Der Text-Encoder erstellt textbasierte Nachrichten auf dem Draht. Nachrichten, die von diesem Encoder erzeugt werden, eignen sich für WS-*-basierte Interoperabilität. Der Webdienst- oder Webdienstclient kann textbezogenes XML im Allgemeinen verstehen. Die Übertragung großer Binärdatenblöcke als Text ist jedoch die am wenigsten effiziente Methode zum Codieren von XML-Nachrichten.

Example

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

Siehe auch

  • Last updated on