<mtomMessageEncoding>
指定用于基于 SOAP 消息传输优化机制 (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。 |
父元素
元素 | 说明 |
---|---|
定义自定义绑定的所有绑定功能。 |
备注
编码是将消息转换为一个字节序列的过程。解码是反向过程。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