MtomMessageEncodingBindingElement 類別

定義

命名空間:
System.ServiceModel.Channels
組件:
System.ServiceModel.dll, System.ServiceModel.Primitives.dll
組件:
System.ServiceModel.dll
組件:
System.ServiceModel.Primitives.dll
套件:
System.ServiceModel.Primitives v10.0.652802
來源:
MtomMessageEncodingBindingElement.cs
來源:
MtomMessageEncodingBindingElement.cs
來源:
MtomMessageEncodingBindingElement.cs

綁定元素，規定訊息傳輸優化機制（MTOM）訊息所使用的編碼與版本控制。

public ref class MtomMessageEncodingBindingElement sealed : System::ServiceModel::Channels::MessageEncodingBindingElement
public ref class MtomMessageEncodingBindingElement sealed : System::ServiceModel::Channels::MessageEncodingBindingElement, System::ServiceModel::Description::IPolicyExportExtension, System::ServiceModel::Description::IWsdlExportExtension
public sealed class MtomMessageEncodingBindingElement : System.ServiceModel.Channels.MessageEncodingBindingElement
public sealed class MtomMessageEncodingBindingElement : System.ServiceModel.Channels.MessageEncodingBindingElement, System.ServiceModel.Description.IPolicyExportExtension, System.ServiceModel.Description.IWsdlExportExtension
type MtomMessageEncodingBindingElement = class
    inherit MessageEncodingBindingElement
type MtomMessageEncodingBindingElement = class
    inherit MessageEncodingBindingElement
    interface IWsdlExportExtension
    interface IPolicyExportExtension
Public NotInheritable Class MtomMessageEncodingBindingElement
Inherits MessageEncodingBindingElement
Public NotInheritable Class MtomMessageEncodingBindingElement
Inherits MessageEncodingBindingElement
Implements IPolicyExportExtension, IWsdlExportExtension
繼承
Object
BindingElement
MessageEncodingBindingElement
MtomMessageEncodingBindingElement
實作
IPolicyExportExtension IWsdlExportExtension

備註

編碼是將訊息轉換為一串位元組的過程。 解碼則是相反的過程。 Windows 通訊基金會（WCF）包含三種 SOAP 訊息的編碼方式：文字、二進位及訊息傳輸優化機制（MTOM）。

代表 MtomMessageEncodingBindingElement 綁定元素，指定字元編碼、訊息版本控制及其他訊息設定，使用訊息傳輸優化機制（MTOM）編碼。 MTOM 是一種在 WCF 訊息中傳輸二進位數據的有效技術。 MTOM 編碼器會嘗試在效率與互作性之間建立平衡。 MTOM 編碼以文字形式傳送大部分 XML，但透過傳送大量二進位資料 as-is，且不轉換成 base64 編碼格式，以優化大量二進位資料區塊。

關於指定訊息以文字表示 XML 編碼的綁定元素的更多資訊，請參見 TextMessageEncodingBindingElement。

關於指定訊息以 XML .NET 二進位格式編碼的綁定元素，請參見 BinaryMessageEncodingBindingElement。

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

建構函式

名稱 Description
MtomMessageEncodingBindingElement()

初始化 MtomMessageEncodingBindingElement 類別的新執行個體。
MtomMessageEncodingBindingElement(MessageVersion, Encoding)

初始化類別的新實例 MtomMessageEncodingBindingElement ，並指定訊息版本與字元編碼。

屬性

名稱 Description
MaxBufferSize

取得或設定最大緩衝區大小。
MaxReadPoolSize

取得或設定分配給池池且已準備好處理來電訊息的最大 XML 讀取器數量。
MaxWritePoolSize

取得或設定分配給池池並準備處理發出訊息的最大 XML 寫入者數量。
MessageVersion

接收或設定 SOAP 訊息，並 WS-Addressing 使用或預期的版本。
ReaderQuotas

取得或設定對可由端點處理的 XML 訊息複雜度設限，這些訊息由配置使用此綁定元素。
WriteEncoding

取得或設定用於格式化文字訊息字元的編碼。

方法

名稱 Description
BuildChannelFactory<TChannel>(BindingContext)

在用戶端建立通道工廠堆疊，為特定情境建立特定類型的通道。
BuildChannelListener<TChannel>(BindingContext)

在用戶端建立通道監聽器堆疊，接受特定類型通道以符合特定情境。
CanBuildChannelFactory<TChannel>(BindingContext)

回傳一個值，表示目前綁定是否能為特定類型的通道與上下文建立工廠。
CanBuildChannelListener<TChannel>(BindingContext)

回傳一個值，表示目前綁定是否能為特定類型的通道與上下文建立監聽器。
Clone()

建立 MtomMessageEncodingBindingElement 一個由目前物件初始化的新物件。
CreateMessageEncoderFactory()

建立一個訊息編碼工廠，用來編碼 MTOM 訊息。
Equals(Object)

判斷指定的物件是否等於目前的物件。

(繼承來源 Object)
GetHashCode()

做為預設哈希函式。

(繼承來源 Object)
GetProperty<T>(BindingContext)

回傳一個類型物件，若存在，則來自綁定元素堆疊中相應層。
GetType()

取得目前實例的 Type。

(繼承來源 Object)
MemberwiseClone()

建立目前 Object的淺層複本。

(繼承來源 Object)
ShouldSerializeMessageVersion()

回傳是否應該序列化 SOAP 訊息結構版本。
ShouldSerializeReaderQuotas()

回傳是否應該序列化對 SOAP 訊息結構複雜度的限制。
ShouldSerializeWriteEncoding()

回傳 Encoding 是否用於格式化訊息字元的 ，是否應該序列化。
ToString()

傳回表示目前 物件的字串。

(繼承來源 Object)

明確介面實作

名稱 Description
IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext)

在產生 WSDL 時插入一項政策斷言，表示正在使用 MTOM 編碼。
IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext)

修改WSDL合約以提供MTOM特定資訊。
IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext)

將 SOAP 訊息版本放入 WSDL。

適用於