BinaryMessageEncodingElement 类

定义

命名空间:

System.ServiceModel.Configuration

程序集:

System.ServiceModel.dll

表示一个在网络上以二进制形式对 Windows Communication Foundation (WCF) 消息进行编码的消息编码器。 此类不能被继承。

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

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

type BinaryMessageEncodingElement = class
    inherit BindingElementExtensionElement

Public NotInheritable Class BinaryMessageEncodingElement
Inherits BindingElementExtensionElement

继承

Object

ConfigurationElement

ServiceModelConfigurationElement

ServiceModelExtensionElement

BindingElementExtensionElement

BinaryMessageEncodingElement

注解

编码是将一组 Unicode 字符转换为一个字节序列的过程。

BinaryMessageEncodingElement 类表示一个配置节，该配置节指定基于二进制的 XML 消息所使用的字符编码和消息版本管理。 二进制消息编码器在网络上以二进制格式对 WCF 消息进行编码。 虽然这种编码有助于非常快速地传输消息，但是丢失了基于 WS-* 标准的互操作性。

MtomMessageEncodingElement 类表示一个配置节，该配置节指定使用消息传输优化机制 (MTOM) 编码的消息所使用的字符编码和消息版本管理。 MTOM 是一种用于在 WCF 消息中传输二进制数据的有效技术。 MTOM 编码器力图在效率和互操作性之间取得平衡。 MTOM 编码以文本形式传输大多数 XML，但是会通过按原样（即不转换为文本）的方式传输来优化大型二进制数据块。

TextMessageEncodingElement 类表示一个配置节，该配置节指定一个用于在网络上创建基于文本的消息的文本编码器。 此编码器产生的消息适合于基于 WS-* 的互操作性。 Web 服务或 Web 服务客户端通常可以理解文本 XML。 但是，对于 XML 消息编码来说，以文本形式传输较大的二进制数据块是最低效的方法。

构造函数

BinaryMessageEncodingElement()

初始化 BinaryMessageEncodingElement 类的新实例。

属性

BindingElementType	获取此绑定元素的类型。
CompressionFormat	获取或设置二进制消息编码元素中使用的压缩格式。
ConfigurationElementName	获取此配置元素的名称。 (继承自 ServiceModelExtensionElement)
CurrentConfiguration	获取对顶级 Configuration 实例的引用，该实例表示当前 ConfigurationElement 实例所属的配置层次结构。 (继承自 ConfigurationElement)
ElementInformation	获取包含 ConfigurationElement 对象的不可自定义的信息和功能的 ElementInformation 对象。 (继承自 ConfigurationElement)
ElementProperty	获取表示 ConfigurationElement 对象本身的 ConfigurationElementProperty 对象。 (继承自 ConfigurationElement)
EvaluationContext	获取 ConfigurationElement 对象的 ContextInformation 对象。 (继承自 ConfigurationElement)
HasContext	获取一个值，该值指示 CurrentConfiguration 属性是否为 null。 (继承自 ConfigurationElement)
Item[ConfigurationProperty]	获取或设置此配置元素的属性或特性。 (继承自 ConfigurationElement)
Item[String]	获取或设置此配置元素的属性、特性或子元素。 (继承自 ConfigurationElement)
LockAllAttributesExcept	获取被锁定的特性的集合。 (继承自 ConfigurationElement)
LockAllElementsExcept	获取被锁定的元素的集合。 (继承自 ConfigurationElement)
LockAttributes	获取被锁定的特性的集合。 (继承自 ConfigurationElement)
LockElements	获取被锁定的元素的集合。 (继承自 ConfigurationElement)
LockItem	获取或设置一个值，该值指示是否已锁定该元素。 (继承自 ConfigurationElement)
MaxReadPoolSize	获取或设置一个值，该值指定无需分配新读取器便可同时读取的最大消息数。
MaxSessionSize	获取或设置一个值，该值指定用于编码的缓冲区的大小（以字节为单位）。
MaxWritePoolSize	获取或设置一个值，该值指定无需分配新编写器便可同时发送的最大消息数。
Properties	获取属性的集合。 (继承自 ConfigurationElement)
ReaderQuotas	获取或设置可由配置了此绑定的终结点处理的 SOAP 消息的复杂性约束。

方法

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)	获取一个值，该值指示反序列化过程中是否遇到未知特性。 (继承自 ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	获取一个值，该值指示反序列化过程中是否遇到未知元素。 (继承自 ConfigurationElement)
OnRequiredPropertyNotFound(String)	找不到所需属性时引发异常。 (继承自 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()	设置 ConfigurationElement 对象及所有子元素的 IsReadOnly() 属性。 (继承自 ConfigurationElement)
ToString()	返回表示当前对象的字符串。 (继承自 Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	修改 ConfigurationElement 对象以移除所有不应该保存的值。 (继承自 ConfigurationElement)

另请参阅

• BinaryMessageEncodingBindingElement