<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 バージョンを指定します。有効な値は、以下のとおりです。
既定値は Soap12Addressing10 です。この属性は MessageVersion 型です。 |
writeEncoding |
バインディングでメッセージの発行に使用される文字セット エンコーディングを指定します。有効な値は、以下のとおりです。
既定値は Utf8TextEncoding です。この属性は Encoding 型です。 |
子要素
要素 | 説明 |
---|---|
このバインディングを使用して設定されるエンドポイントにより処理可能な、SOAP メッセージの複雑さに対する制約を定義します。この要素は XmlDictionaryReaderQuotasElement 型です。 |
親要素
要素 | 説明 |
---|---|
カスタム バインディングのすべてのバインディング機能を定義します。 |
解説
エンコーディングは、メッセージをバイト シーケンスに変換するプロセスです。デコードは、その逆のプロセスです。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