<textMessageEncoding>
指定字元編碼和訊息版本處理,用於文字 XML 訊息。
<configuration>
<system.serviceModel>
<bindings>
<customBinding>
<binding>
<textMessageEncoding>
Syntax
<textMessageEncoding maxReadPoolSize="Integer"
maxWritePoolSize="Integer"
messageVersion="Soap11Addressing10/Soap12Addressing10"
writeEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding" />
屬性和項目
下列章節說明屬性、子元素和父元素。
屬性
屬性 | 描述 |
---|---|
maxReadPoolSize | 整數,指定可以同時讀取而不需配置新讀取器的訊息數。 較大的集區大小可讓系統容許更多活動失效的情況,但是會產生較大的工作集。 預設值為 64。 |
maxWritePoolSize | 整數,指定可以同時傳送而不需配置新寫入器的訊息數。 較大的集區大小可讓系統容許更多活動失效的情況,但是會產生較大的工作集。 預設值是 16。 |
messageVersion | 指定使用這個繫結所傳送訊息的 SOAP 版本。 有效值為 - Soap11Addressing10 - Soap12Addressing10 - Soap11 - Soap12 預設為 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" />