TextMessageEncodingElement 類別

定義

命名空間:

System.ServiceModel.Configuration

組件:

System.ServiceModel.dll

表示組態項目，指定用於文字 XML 訊息的字元編碼和訊息版本處理。 此類別無法獲得繼承。

public ref class TextMessageEncodingElement sealed : System::ServiceModel::Configuration::BindingElementExtensionElement

public sealed class TextMessageEncodingElement : System.ServiceModel.Configuration.BindingElementExtensionElement

type TextMessageEncodingElement = class
    inherit BindingElementExtensionElement

Public NotInheritable Class TextMessageEncodingElement
Inherits BindingElementExtensionElement

繼承

Object

ConfigurationElement

ServiceModelExtensionElement

BindingElementExtensionElement

TextMessageEncodingElement

繼承

Object

ConfigurationElement

ServiceModelConfigurationElement

ServiceModelExtensionElement

BindingElementExtensionElement

TextMessageEncodingElement

備註

文字編碼器會在網路上建立文字訊息。 此編碼器產生的訊息適合 WS-* 型的互通性。

編碼是將一組 Unicode 字元轉換成位元組序列的處理程序。

這個組態區段指定的文字編碼器會在網路上建立文字訊息。 此編碼器產生的訊息適合 WS-* 型的互通性。 Web 服務或 Web 服務用戶端通常可以了解文字 XML。 不過，若要針對 XML 訊息進行編碼，將大型二進位資料區塊當做文字傳輸是效率最差的方法。

BinaryMessageEncodingElement 類別表示組態項目，指定用於二進位 XML 訊息的字元編碼和訊息版本處理。 這是最有效率、但互通性最差的編碼選項。

MtomMessageEncodingElement 類別表示組態項目，為使用訊息傳輸最佳化機制 (MTOM) 編碼的訊息指定字元編碼和訊息版本處理。 MTOM 是在 Windows Communication Foundation (WCF) 訊息中傳輸二進位資料的有效技術。 MTOM 編碼器會嘗試在效率和互通性之間保持平衡。 MTOM 編碼方式會以文字格式傳輸大部分的 XML，但是在傳輸大型區塊的二進位資料時，會依照原狀來傳送 (不轉換成文字)，好讓這些資料最佳化。

建構函式

TextMessageEncodingElement()

初始化 TextMessageEncodingElement 類別的新執行個體。

屬性

BindingElementType	取得這個組態項目的 Type。
ConfigurationElementName	取得這個組態項目的名稱。 (繼承來源 ServiceModelExtensionElement)
CurrentConfiguration	取得最上層 Configuration 執行個體的參考，這個執行個體表示目前 ConfigurationElement 執行個體所屬的組態階層架構。 (繼承來源 ConfigurationElement)
ElementInformation	取得 ElementInformation 物件，其中包含 ConfigurationElement 物件之不可自訂的資訊和功能。 (繼承來源 ConfigurationElement)
ElementProperty	取得表示 ConfigurationElementProperty 物件本身的 ConfigurationElement 物件。 (繼承來源 ConfigurationElement)
EvaluationContext	取得 ConfigurationElement 物件的 ContextInformation 物件。 (繼承來源 ConfigurationElement)
HasContext	取得值，指出 CurrentConfiguration 屬性是否為 null。 (繼承來源 ConfigurationElement)
Item[ConfigurationProperty]	取得或設定此組態項目的屬性 (Property) 或屬性 (Attribute)。 (繼承來源 ConfigurationElement)
Item[String]	取得或設定此一組態項目的屬性或子項目。 (繼承來源 ConfigurationElement)
LockAllAttributesExcept	取得已鎖定屬性的集合。 (繼承來源 ConfigurationElement)
LockAllElementsExcept	取得已鎖定項目的集合。 (繼承來源 ConfigurationElement)
LockAttributes	取得已鎖定屬性的集合。 (繼承來源 ConfigurationElement)
LockElements	取得已鎖定項目的集合。 (繼承來源 ConfigurationElement)
LockItem	取得或設定值，指出此項目是否已被鎖定。 (繼承來源 ConfigurationElement)
MaxReadPoolSize	取得或設定值，其中指定可以同時讀取，而不需配置新讀取器的最大訊息數。
MaxWritePoolSize	取得或設定值，其中指定可以同時傳送，而不需配置新寫入器的最大訊息數。
MessageVersion	取得或設定用於格式化使用此繫結傳送的文字訊息的 SOAP 和 WS-Addressing 版本。
Properties	取得屬性的集合。 (繼承來源 ConfigurationElement)
ReaderQuotas	取得或設定 SOAP 訊息複雜性的條件約束，而這些條件約束可由以此繫結所設定的端點處理。
WriteEncoding	取得或設定要在繫結上發出訊息時使用的字元集編碼方式。

方法

ApplyConfiguration(BindingElement)	將指定之繫結項目的內容套用至這個繫結組態區段。
CopyFrom(ServiceModelExtensionElement)	將指定之組態區段的內容複製到這個項目。
CreateBindingElement()	在衍生類別中覆寫時，傳回自訂繫結項目物件。 (繼承來源 BindingElementExtensionElement)
DeserializeElement(XmlReader, Boolean)	從組態檔讀取 XML。 (繼承來源 ConfigurationElement)
Equals(Object)	將目前的 ConfigurationElement 執行個體與指定的物件相比較。 (繼承來源 ConfigurationElement)
GetHashCode()	取得表示目前 ConfigurationElement 執行個體的唯一值。 (繼承來源 ConfigurationElement)
GetTransformedAssemblyString(String)	傳回指定之組件名稱的轉換版本。 (繼承來源 ConfigurationElement)
GetTransformedTypeString(String)	傳回指定之型別名稱的轉換版本。 (繼承來源 ConfigurationElement)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
Init()	將 ConfigurationElement 物件設定為它的初始狀態。 (繼承來源 ConfigurationElement)
InitializeDefault()	用來初始化 ConfigurationElement 物件的預設值集。 (繼承來源 ConfigurationElement)
InitializeFrom(BindingElement)	使用指定之繫結項目的內容，初始化此繫結組態區段。 (繼承來源 BindingElementExtensionElement)
IsModified()	取得值，指出這個組態項目是否經過修改。 (繼承來源 ServiceModelExtensionElement)
IsReadOnly()	取得值，這個值表示 ConfigurationElement 物件是否唯讀。 (繼承來源 ConfigurationElement)
ListErrors(IList)	將這個 ConfigurationElement 物件中和所有子項目中的無效屬性錯誤加入傳遞的清單。 (繼承來源 ConfigurationElement)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
OnDeserializeUnrecognizedAttribute(String, String)	取得值，指出在還原序列化程序中是否遇到未知的屬性 (Attribute)。 (繼承來源 ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	取得值，指出在還原序列化程序中是否遇到未知的項目。 (繼承來源 ConfigurationElement)
OnRequiredPropertyNotFound(String)	在找不到必要的屬性時擲回例外狀況 (Exception)。 (繼承來源 ConfigurationElement)
PostDeserialize()	還原序列化之後呼叫。 (繼承來源 ConfigurationElement)
PreSerialize(XmlWriter)	序列化之前呼叫。 (繼承來源 ConfigurationElement)
Reset(ConfigurationElement)	重設這個組態項目物件的內部狀態，包括鎖定和屬性集合。 (繼承來源 ServiceModelExtensionElement)
ResetModified()	在衍生類別中實作時，將 IsModified() 方法的值重設為 false。 (繼承來源 ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	將這個組態項目的內容寫入組態檔。 (繼承來源 ServiceModelExtensionElement)
SerializeToXmlElement(XmlWriter, String)	在衍生類別中實作時，將此組態項目的外部標記寫入組態檔中。 (繼承來源 ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	將屬性設定為指定的值。 (繼承來源 ConfigurationElement)
SetPropertyValueIfNotDefaultValue<T>(String, T)	如果值不是預設值，則設定組態項目的屬性值。 (繼承來源 ServiceModelConfigurationElement)
SetReadOnly()	設定 IsReadOnly() 物件和所有子項目的 ConfigurationElement 屬性。 (繼承來源 ConfigurationElement)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	修改 ConfigurationElement 物件，以移除不應該儲存的所有值。 (繼承來源 ConfigurationElement)

另請參閱

• TextMessageEncodingBindingElement
• Configuration 中的 TextMessageEncoding