通过

<textMessageEncoding>

  • 项目

指定用于基于文本的 XML 消息的字符编码和消息版本控制。

架构层次结构

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

语法

<textMessageEncoding maxReadPoolSize="Integer"
   maxWritePoolSize="Integer"
   messageVersion="Soap11Addressing10/Soap12Addressing10"
      writeEncoding=”UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding" />

属性和元素

以下几节描述了特性、子元素和父元素。

属性

特性 说明

maxReadPoolSize

一个整数，指定在无需分配新读取器的情况下可以同时读取的消息数。池大小越大，系统允许的活动峰值就越大，但工作集也会随之增大。默认值为 64。

maxWritePoolSize

一个整数，指定在无需分配新编写器的情况下可以同时发送的消息数。池大小越大，系统允许的活动峰值就越大，但工作集也会随之增大。默认值为 16。

messageVersion

指定使用此绑定发送的消息的 SOAP 版本。有效值为

  • Soap11Addressing10

  • Soap12Addressing10

默认值为 Soap12Addressing10。此属性的类型为 MessageVersion。

writeEncoding

指定要用来在绑定上发出消息的字符集编码。有效值为

  • UnicodeFffeTextEncoding：Unicode BigEndian 编码

  • Utf16TextEncoding：Unicode 编码

  • Utf8TextEncoding：8 位编码

默认值为 Utf8TextEncoding。此属性的类型为 Encoding。

子元素

元素 说明

<readerQuotas>

定义可由采用此绑定配置的终结点进行处理的 SOAP 消息的复杂性约束。此元素的类型为 XmlDictionaryReaderQuotasElement。

父元素

元素 说明

<binding>

定义自定义绑定的所有绑定功能。

备注

编码是将消息转换为一个字节序列的过程。解码是反向过程。Windows Communication Foundation (WCF) 包含三种类型的 SOAP 消息编码：文本、二进制和消息传输优化机制 (MTOM)。

由 textMessageEncoding 元素表示的文本编码互操作性最强，但却是效率最低的 XML 消息编码器。文本编码器在网络上创建基于文本的消息。此编码器产生的消息适合于基于 WS-* 的互操作性。Web 服务或 Web 服务客户端通常可以理解文本 XML。但是，对于 XML 消息编码来说，以文本形式传输较大的二进制数据块是最低效的方法。

示例

<textMessageEncoding maxReadPoolSize="211"
    maxWritePoolSize="2132"
    messageVersion="Soap12Addressing10"
    textEncoding=”utf-8” />

另请参见

参考

<customBinding>
TextMessageEncodingElement
CustomBinding
MessageEncodingBindingElement
TextMessageEncodingBindingElement

概念

消息编码

其他资源

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