<textMessageEncoding>

[アーティクル]
09/12/2008

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

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

<textMessageEncoding maxReadPoolSize="Integer"
   maxWritePoolSize="Integer"
   messageVersion="Soap11Addressing1/Soap12Addressing1"
      writeEncoding=”UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding" />

属性および要素

属性

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

次の方法で共有

<textMessageEncoding>

属性および要素

属性

子要素

親要素

解説

例

関連項目

リファレンス

概念

その他の技術情報

その他のリソース