TextMessageEncodingBindingElement 类

定义

命名空间:

System.ServiceModel.Channels

程序集:

System.ServiceModel.Primitives.dll

包:

System.ServiceModel.Primitives v6.2.0

Source:

TextMessageEncodingBindingElement.cs

绑定元素，指定用于基于文本的 SOAP 消息的字符编码与消息版本管理。

public ref class TextMessageEncodingBindingElement sealed : System::ServiceModel::Channels::MessageEncodingBindingElement

public sealed class TextMessageEncodingBindingElement : System.ServiceModel.Channels.MessageEncodingBindingElement

type TextMessageEncodingBindingElement = class
    inherit MessageEncodingBindingElement

Public NotInheritable Class TextMessageEncodingBindingElement
Inherits MessageEncodingBindingElement

继承

Object

BindingElement

MessageEncodingBindingElement

TextMessageEncodingBindingElement

注解

编码是将消息转换为一个字节序列的过程。 解码是反向过程。 Windows Communication Foundation (WCF) 包含三种类型的 SOAP 消息编码：文本、二进制和消息传输优化机制 (MTOM)。

由 TextMessageEncodingBindingElement 表示的文本编码互操作性最强，但效率最低的 XML 消息编码器。 Web 服务或 Web 服务客户端通常可以理解文本 XML。 但是，将大型二进制数据块作为文本传输不是有效的传输方式。

有关使用用于 XML 的 .NET 二进制格式对消息进行编码的绑定元素的详细信息，请参阅 BinaryMessageEncodingBindingElement。

有关指定使用 MTOM 消息编码对消息进行编码的绑定元素的详细信息，请参阅 MtomMessageEncodingBindingElement。

有关如何实现自定义消息编码器的详细信息，请使用 MessageEncodingBindingElement 类。

构造函数

TextMessageEncodingBindingElement()	初始化 TextMessageEncodingBindingElement 类的新实例。
TextMessageEncodingBindingElement(MessageVersion, Encoding)	使用指定的消息版本和编码初始化 TextMessageEncodingBindingElement 类的新实例。

属性

MaxReadPoolSize	获取或设置读取器数量，该读取器会被分配到池中，并随时可以用于处理传入消息。
MaxWritePoolSize	获取或设置编写器数量，该编写器会被分配到池中，并随时可以用于处理传出消息。
MessageVersion	获取或设置用于格式化文本消息的 SOAP 和 WS-Addressing 版本。
ReaderQuotas	获取或设置可由配置了此绑定的终结点处理的 SOAP 消息的复杂性约束。
WriteEncoding	获取或设置用于格式化文本消息中字符的编码。

方法

BuildChannelFactory<TChannel>(BindingContext)	在客户端上生成通道工厂堆栈，该通道工厂堆栈可为指定上下文创建指定类型的通道。
BuildChannelListener<TChannel>(BindingContext)	初始化通道侦听器，用于接受绑定上下文中指定类型的通道。 (继承自 BindingElement)
CanBuildChannelFactory<TChannel>(BindingContext)	返回一个值，该值指示绑定元素是否可以为特定类型的通道生成通道工厂。 (继承自 BindingElement)
CanBuildChannelListener<TChannel>(BindingContext)	返回一个值，该值指示绑定元素是否可以为特定类型的通道生成侦听器。 (继承自 BindingElement)
Clone()	创建一个从当前对象初始化的新 TextMessageEncodingBindingElement 对象。
CreateMessageEncoderFactory()	创建一个文本消息编码器工厂，该文本消息编码器利用由当前编码绑定元素指定的消息版本与字符编码。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetProperty<T>(BindingContext)	从绑定元素堆栈的适当层返回所请求的类型化对象（如果存在）。
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ToString()	返回表示当前对象的字符串。 (继承自 Object)