MtomMessageEncodingBindingElement 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
繫結項目,這個繫結項目會指定用於訊息傳輸最佳化機制 (Message Transmission Optimization Mechanism,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
- 繼承
- 實作
備註
編碼是將訊息轉換成位元組序列的處理序, 解碼則是相反的處理序。 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 |
取得或設定用於格式化文字訊息字元的編碼。 |
方法
明確介面實作
IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext) |
將產生的原則判斷提示插入 WSDL,該原則判斷提示會指出正在使用 MTOM 編碼。 |
IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext) |
修改 MTOM 特定的資訊 WSDL 合約。 |
IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext) |
將 SOAP 訊息版本置入 WSDL。 |
適用於
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應