<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>

定義自訂繫結的所有繫結功能。

備註

編碼是將訊息轉換成位元組序列的處理序,解碼則是相反的處理序。Windows Communication Foundation (WCF) 包含 SOAP 訊息的三種編碼類型:文字、二進位和訊息傳輸最佳化機制 (MTOM)。

MtomMessageEncoding 項目會為使用訊息傳輸最佳化機制 (MTOM) 編碼的訊息,指定使用的字元編碼、訊息版本控制以及其他設定。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