規定用於文字基礎 XML 訊息的字元編碼與訊息版本控制。
<configuration>
<system.serviceModel>
<bindings>
<customBinding>
<binding>
<textMessageEncoding>
語法
<textMessageEncoding maxReadPoolSize="Integer"
maxWritePoolSize="Integer"
messageVersion="Soap11Addressing10/Soap12Addressing10"
writeEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding" />
屬性和項目
下列章節說明屬性、子元素和父元素。
Attributes
| Attribute | Description |
|---|---|
| maxReadPool 大小 | 一個整數,指定可同時閱讀多少訊息而不分配新讀取器。 較大的池數使系統對活動峰值更具容忍度,但代價是工作組容量較大。 預設值為 64。 |
| maxWritePoolSize | 一個整數,指定可以同時傳送多少則訊息而不分配新寫入者。 較大的池數使系統對活動峰值更具容忍度,但代價是工作組容量較大。 預設值為 16。 |
| messageVersion | 指定使用綁定傳送訊息的 SOAP 版本。 有效的數值為 - Soap11Addressing10 - Soap12 地址10 - 肥皂劇11 - 肥皂12 預設為 Soap12Addressing10。 此屬性的類型 MessageVersion為 。 |
| write編碼 | 指定用於綁定訊息的字元集編碼。 有效的數值為 - UnicodeFffeTextEncoding:Unicode BigEndian 編碼 - Utf16TextEncoding:Unicode 編碼 - Utf8TextEncoding:8位元編碼 預設是 Utf8TextEncoding。 此屬性的類型 Encoding為 。 |
子專案
| 元素 | Description |
|---|---|
| <讀者配額> | 定義了由端點可處理的 SOAP 訊息複雜度的限制,這些訊息可由配置為此綁定的端點所能處理。 此元素的類型 XmlDictionaryReaderQuotasElement為 。 |
父項目
| 元素 | Description |
|---|---|
| <裝訂> | 定義自訂綁定的所有綁定功能。 |
備註
編碼是將訊息轉換為一串位元組的過程。 解碼則是相反的過程。 Windows 通訊基金會(WCF)包含三種 SOAP 訊息的編碼方式:文字、二進位及訊息傳輸優化機制(MTOM)。
以 textMessageEncoding 元素表示的文字編碼是最具互通性,但對 XML 訊息而言效率最低的編碼器。 文字編碼器會在線路上產生基於文字的訊息。 此編碼器產生的訊息適用於基於 WS-* 的互通性。 網路服務或網路服務用戶端通常能理解文字 XML。 然而,將大量二進位資料區塊以文字傳送,是編碼 XML 訊息效率最低的方法。
Example
<textMessageEncoding maxReadPoolSize="211"
maxWritePoolSize="2132"
messageVersion="Soap12Addressing10"
textEncoding="utf-8" />