<textMessageEncoding>

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

スキーマの階層

<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

既定値は Soap12Addressing10 です。この属性は MessageVersion 型です。

writeEncoding

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

  • UnicodeFffeTextEncoding: Unicode BigEndian エンコーディング

  • Utf16TextEncoding: Unicode エンコーディング

  • Utf8TextEncoding: 8 ビットのエンコーディング

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

子要素

要素 説明

<readerQuotas>

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

親要素

要素 説明

<binding>

カスタム バインディングのすべてのバインディング機能を定義します。

解説

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

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

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

参照

リファレンス

<customBinding>
TextMessageEncodingElement
CustomBinding
MessageEncodingBindingElement
TextMessageEncodingBindingElement

概念

メッセージ エンコーディング

その他のリソース

Choosing a Message Encoder
Windows Communication Foundation Bindings
Extending Bindings
Custom Bindings