TextMessageEncodingElement 类

定义

命名空间:

System.ServiceModel.Configuration

程序集:

System.ServiceModel.dll

表示一个配置元素，该配置元素指定用于基于文本的 XML 消息的字符编码和消息版本管理。 此类不能被继承。

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

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

type TextMessageEncodingElement = class
    inherit BindingElementExtensionElement

Public NotInheritable Class TextMessageEncodingElement
Inherits BindingElementExtensionElement

继承

Object

ConfigurationElement

ServiceModelConfigurationElement

ServiceModelExtensionElement

BindingElementExtensionElement

TextMessageEncodingElement

注解

文本编码器在网络上创建基于文本的消息。 此编码器产生的消息适合于基于 WS-* 的互操作性。

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

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

BinaryMessageEncodingElement 类表示一个配置元素，该配置元素指定基于二进制的 XML 消息所使用的字符编码和消息版本管理。 这是效率最高但互操作性最低的编码选项。

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

构造函数

TextMessageEncodingElement()

初始化 TextMessageEncodingElement 类的新实例。

属性

BindingElementType	获取此配置元素的 Type。
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	获取或设置一个值，该值指定无需分配新读取器便可同时读取的最大消息数。
MaxWritePoolSize	获取或设置一个值，该值指定无需分配新编写器便可同时发送的最大消息数。
MessageVersion	获取或设置用于对使用此绑定发送的文本消息进行格式设置的 SOAP 和 WS-Addressing 版本。
Properties	获取属性的集合。 (继承自 ConfigurationElement)
ReaderQuotas	获取或设置可由配置了此绑定的终结点处理的 SOAP 消息的复杂性约束。
WriteEncoding	获取或设置要用于在绑定上发出消息的字符集编码。

方法

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)

另请参阅

• TextMessageEncodingBindingElement
• 配置中的 TextMessageEncoding