TextMessageEncodingBindingElement 類別

定義

命名空間:

System.ServiceModel.Channels

組件:

System.ServiceModel.Primitives.dll

組件:

System.ServiceModel.dll

此繫結項目會指定用於 SOAP 文字訊息的字元編碼和訊息版本控制。

C#

public sealed class TextMessageEncodingBindingElement : System.ServiceModel.Channels.MessageEncodingBindingElement

C#

public sealed class TextMessageEncodingBindingElement : System.ServiceModel.Channels.MessageEncodingBindingElement, System.ServiceModel.Description.IPolicyExportExtension, System.ServiceModel.Description.IWsdlExportExtension

繼承

Object

BindingElement

MessageEncodingBindingElement

TextMessageEncodingBindingElement

實作

IPolicyExportExtension IWsdlExportExtension

備註

編碼是將訊息轉換成位元組序列的處理序， 解碼則是相反的處理序。 Windows Communication Foundation (WCF) 包含 SOAP 訊息的三種編碼類型：文字、二進位和訊息傳輸最佳化機制 (MTOM)。

TextMessageEncodingBindingElement 所代表的文字編碼為最具互通性，但針對 XML 訊息編碼器的效率最為不彰。 Web 服務或 Web 服務用戶端通常可以了解文字 XML。 不過，將大型二進位資料區塊當做文字來傳輸是沒有效率的。

如需使用 .NET Binary Format for XML 編碼之繫結項目的詳細資訊，請參閱 BinaryMessageEncodingBindingElement 。

如需使用 MTOM 訊息編碼來編碼之繫結項目的詳細資訊，請參閱 MtomMessageEncodingBindingElement 。

如需如何實作自訂訊息編碼器的詳細資訊，請使用 類別 MessageEncodingBindingElement 。

建構函式

TextMessageEncodingBindingElement()	初始化 TextMessageEncodingBindingElement 類別的新執行個體。
TextMessageEncodingBindingElement(MessageVersion, Encoding)	使用指定的訊息版本和編碼，初始化 TextMessageEncodingBindingElement 類別的新執行個體。

屬性

MaxReadPoolSize	取得或設定寫入器的數目，這些是配置於集區、準備用來處理傳入訊息的寫入器。
MaxWritePoolSize	取得或設定寫入器的數目，這些是配置於集區、準備用來處理傳出訊息的寫入器。
MessageVersion	取得或設定用於格式化文字訊息的 SOAP 和 WS-Addressing 版本。
ReaderQuotas	取得或設定 SOAP 訊息複雜性的條件約束，而這些條件約束可由以此繫結所設定的端點處理。
WriteEncoding	取得或設定用於格式化文字訊息字元的編碼。

方法

BuildChannelFactory<TChannel>(BindingContext)	在用戶端上建置通道處理站堆疊，這個堆疊會針對指定的內容建立指定的通道類型。
BuildChannelListener<TChannel>(BindingContext)	在服務上建置通道接聽程式，針對指定的內容，接受指定的通道型別。
BuildChannelListener<TChannel>(BindingContext)	初始化通道接聽項，以便從繫結內容接受指定之類型的通道。 (繼承來源 BindingElement)
CanBuildChannelFactory<TChannel>(BindingContext)	傳回值，指出繫結項目是否可以建置 (Build) 特定通道類型的通道處理站。 (繼承來源 BindingElement)
CanBuildChannelListener<TChannel>(BindingContext)	傳回值，這個值會指出目前的繫結是否可以建置指定之通道及內容類型的接聽程式。
CanBuildChannelListener<TChannel>(BindingContext)	傳回值，指出繫結項目是否可以建置特定通道型別的通道接聽程式。 (繼承來源 BindingElement)
Clone()	新建一個從目前 TextMessageEncodingBindingElement 物件初始化的這類物件。
CreateMessageEncoderFactory()	建立文字訊息編碼器處理站，這個處理站會採用目前編碼繫結項目所指定的訊息版本與字元編碼。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetProperty<T>(BindingContext)	從繫結項目堆疊的適當層次中，傳回要求的型別物件 (如果有的話)。
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ShouldSerializeReaderQuotas()	傳回是否應序列化針對 SOAP 訊息結構複雜度所設立的約束條件。
ShouldSerializeWriteEncoding()	傳回是否應序列化用於格式化訊息字元的 Encoding。
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

明確介面實作

IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext)	從繫結項目中包含的編碼原則產生 WSDL 合約資訊。
IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext)	從繫結項目中包含的編碼原則產生 WSDL 合約資訊。
IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext)	從繫結項目中包含的編碼原則產生 WSDL 合約資訊。

適用於