<textMessageEncoding>

  • [アーティクル]

テキストベースの XML メッセージに使用される文字エンコーディングおよびメッセージ バージョン管理を指定します。

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

構文

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

属性および要素

以降のセクションでは、属性、子要素、および親要素について説明します。

属性

属性 説明
maxReadPoolSize 新しいリーダーを割り当てずに同時に読み取り可能なメッセージの数を指定する整数です。 プール サイズを大きくすると、システムでは、比較的大きい作業セットで、アクティビティの急増に対する許容度が高まります。 既定値は、64 です。
maxWritePoolSize 新しいライターを割り当てずに同時に送信可能なメッセージの数を指定する整数です。 プール サイズを大きくすると、システムでは、比較的大きい作業セットで、アクティビティの急増に対する許容度が高まります。 既定値は 16 です。
messageVersion バインディングを使用して送信されたメッセージの SOAP バージョンを指定します。 有効な値は、次のとおりです。

- Soap11Addressing10
- Soap12Addressing10
- Soap11
- Soap12

既定値は Soap12Addressing10 です。 この属性は MessageVersion 型です。
writeEncoding バインドでメッセージの発行に使用される文字セット エンコーディングを指定します。 有効な値は、次のとおりです。

- UnicodeFffeTextEncoding: Unicode BigEndian エンコード
- Utf16TextEncoding: Unicode エンコーディング
- Utf8TextEncoding: 8 ビットのエンコード

既定値は Utf8TextEncoding です。 この属性は Encoding 型です。

子要素

要素 説明
<readerQuotas> このバインドを使用して設定されるエンドポイントにより処理可能な、SOAP メッセージの複雑さに対する制約を定義します。 この要素は XmlDictionaryReaderQuotasElement 型です。

親要素

要素 説明
<binding> カスタム バインドのすべてのバインド機能を定義します。

解説

エンコーディングは、メッセージをバイト シーケンスに変換するプロセスです。 デコードは、その逆のプロセスです。 WCF (Windows Communication Foundation) には、SOAP メッセージのエンコードとして、テキスト、バイナリ、および MTOM (Message Transmission Optimization Mechanism) の 3 種類があります。

textMessageEncoding 要素で表されるテキスト エンコーディングでは相互運用性が最も高くなりますが、XML メッセージのエンコーダーとしての効率は最も低くなります。 テキスト エンコーダーは、ネットワーク上でテキストベースのメッセージを作成します。 このエンコーダーにより生成されるメッセージは、WS-* ベースの相互運用に適しています。 Web サービスまたは Web サービス クライアントは、一般に、テキスト形式の XML を認識できます。 しかし、大きいブロックのバイナリ データをテキストとして転送するのは、XML メッセージをエンコードする上では、最も非効率的な方法です。

例

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

関連項目