MtomMessageEncodingBindingElement 类

定义

命名空间:

System.ServiceModel.Channels

程序集:

System.ServiceModel.Primitives.dll

程序集:

System.ServiceModel.dll

指定消息传输优化机制 (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 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)	在客户端生成通道侦听器堆栈，该通道侦听器堆栈接受针对指定上下文的具有指定类型的通道。
BuildChannelListener<TChannel>(BindingContext)	初始化通道侦听器，用于接受绑定上下文中指定类型的通道。 (继承自 BindingElement)
CanBuildChannelFactory<TChannel>(BindingContext)	返回一个值，该值指示当前绑定是否可以为指定的通道类型和上下文生成工厂。
CanBuildChannelListener<TChannel>(BindingContext)	返回一个值，该值指示当前绑定是否可以为指定的通道类型和上下文生成侦听器。
CanBuildChannelListener<TChannel>(BindingContext)	返回一个值，该值指示绑定元素是否可以为特定类型的通道生成侦听器。 (继承自 BindingElement)
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)

显式接口实现

IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext)	策略断言生成之后会插入到 WSDL 中，指示 MTOM 编码正在使用中。
IWsdlExportExtension.ExportContract(WsdlExporter, WsdlContractConversionContext)	修改 MTOM 特定信息的 WSDL 协定。
IWsdlExportExtension.ExportEndpoint(WsdlExporter, WsdlEndpointConversionContext)	将 SOAP 消息版本放入 WSDL。