MtomMessageEncodingBindingElement 類別

定義

命名空間:

System.ServiceModel.Channels

組件:

System.ServiceModel.Primitives.dll

套件:

System.ServiceModel.Primitives v6.2.0

繫結項目，這個繫結項目會指定用於訊息傳輸最佳化機制 (Message Transmission Optimization Mechanism，MTOM) 訊息的編碼和版本控制。

public ref class MtomMessageEncodingBindingElement sealed : System::ServiceModel::Channels::MessageEncodingBindingElement

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

type MtomMessageEncodingBindingElement = class
    inherit MessageEncodingBindingElement

Public NotInheritable Class MtomMessageEncodingBindingElement
Inherits MessageEncodingBindingElement

繼承

Object

BindingElement

MessageEncodingBindingElement

MtomMessageEncodingBindingElement

備註

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

MtomMessageEncodingBindingElement 表示繫結程序項目，可指定用於使用訊息傳輸最佳化機制 (MTOM) 編碼之訊息的字元編碼、訊息版本控制以及其他設定。 MTOM 是在 WCF 訊息中傳輸二進位資料的有效技術。 MTOM 編碼器會嘗試在效率和互通性之間建立平衡。 MTOM 編碼會以文字格式傳輸大部分的 XML，但是在傳輸大型區塊的二進位資料時，會依照原狀來傳送 (不轉換成其 base64 編碼格式)，好讓這些資料最佳化。

如需指定使用 XML 文字標記法編碼之訊息的繫結項目詳細資訊，請參閱 TextMessageEncodingBindingElement 。

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

如果要實作自訂訊息編碼器，請使用 MessageEncodingBindingElement 類別。

建構函式

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

屬性

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

方法

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