指定用于基于文本的 XML 消息的字符编码和消息版本控制。
<configuration>
<system.serviceModel>
<bindings>
<customBinding>
<binding>
<textMessageEncoding>
Syntax
<textMessageEncoding maxReadPoolSize="Integer"
maxWritePoolSize="Integer"
messageVersion="Soap11Addressing10/Soap12Addressing10"
writeEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding" />
特性和元素
下列各节描述了特性、子元素和父元素。
特性
| Attribute | Description |
|---|---|
| maxReadPoolSize | 一个整数，指定可以同时读取的消息数，而无需分配新的读取器。 较大的池大小使系统能够更容忍活动高峰，但代价是更大的工作集。 默认值为 64。 |
| maxWritePoolSize | 一个整数，指定可以同时发送多少条消息，而无需分配新的编写器。 较大的池大小使系统能够更容忍活动高峰，但代价是更大的工作集。 默认值为 16。 |
| messageVersion | 指定使用绑定发送的消息的 SOAP 版本。 有效值为 - Soap11Addressing10 - Soap12Addressing10 - Soap11 - Soap12 默认值为 Soap12Addressing10。 此属性的类型 MessageVersion为 . |
| writeEncoding | 指定要用于在绑定上发出消息的字符集编码。 有效值为 - UnicodeFffeTextEncoding：Unicode BigEndian 编码 - Utf16TextEncoding：Unicode 编码 - Utf8TextEncoding：8 位编码 默认值为 Utf8TextEncoding。 此属性的类型 Encoding为 . |
子元素
| 元素 | Description |
|---|---|
| <readerQuotas> | 定义由使用此绑定配置的终结点可以处理的 SOAP 消息复杂性的约束。 此元素的类型 XmlDictionaryReaderQuotasElement为 . |
父元素
| 元素 | Description |
|---|---|
| <捆绑> | 定义自定义绑定的所有绑定功能。 |
注解
编码是将消息转换为字节序列的过程。 解码是反向过程。 Windows Communication Foundation （WCF） 包括 SOAP 消息的三种类型的编码：文本、二进制和消息传输优化机制（MTOM）。
元素表示 textMessageEncoding 的文本编码是最可互作的，但 XML 消息效率最低的编码器。 文本编码器在网络上创建基于文本的消息。 此编码器生成的消息适用于基于 WS* 的互作。 Web 服务或 Web 服务客户端通常可以理解文本 XML。 但是，将大型二进制数据块作为文本传输是编码 XML 消息的最低效率方法。
Example
<textMessageEncoding maxReadPoolSize="211"
maxWritePoolSize="2132"
messageVersion="Soap12Addressing10"
textEncoding="utf-8" />
