共用方式為


<textMessageEncoding>

規定用於文字基礎 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" />

另請參閱