<mtomMessageEncoding>

  • [アーティクル]

SOAP Message Transmission Optimization Mechanism (MTOM) ベースのメッセージに使用されるエンコーディングおよびメッセージ バージョン管理を指定します。

スキーマの階層

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

構文

<mtomMessageEncoding 
   maxBufferSize="Integer"
      maxReadPoolSize="Integer"
   maxWritePoolSize="Integer"
   messageVersion="Soap11Addressing1/Soap12Addressing10"
      writeEncoding=”UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding" />

属性と要素

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

属性

属性 説明

maxBufferSize

使用できるバッファーの最大サイズを指定する整数。

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) には、SOAP メッセージのエンコーディングとして、テキスト、バイナリ、および MTOM (Message Transmission Optimization Mechanism) の 3 種類があります。

MtomMessageEncoding 要素は、MTOM (Message Transmission Optimization Mechanism) エンコーディングを使用するメッセージの文字エンコーディング、メッセージのバージョン管理、およびその他の設定を指定します。MTOM は、WCF メッセージでバイナリ データを転送するための効率的なテクノロジです。MTOM エンコーダーは、効率と相互運用性のバランスをとろうとします。MTOM エンコーディングは、ほとんどの XML をテキスト形式で転送しますが、大きいサイズのバイナリ データ ブロックは、base64 でエンコードされた形式に変換せずに、そのまま転送することによって最適化します。

例

<mtomMessageEncoding maxReadPoolSize="211"
    maxWritePoolSize="2132"
    messageVersion=”Soap11Addressing10”
    textEncoding=”utf-8” />

参照

リファレンス

<customBinding>
MtomMessageEncodingElement
CustomBinding
MessageEncodingBindingElement
MtomMessageEncodingBindingElement

概念

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

その他のリソース

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