WebMessageEncodingBindingElement 类

定义

public ref class WebMessageEncodingBindingElement sealed : System::ServiceModel::Channels::MessageEncodingBindingElement, System::ServiceModel::Description::IWsdlExportExtension

public sealed class WebMessageEncodingBindingElement : System.ServiceModel.Channels.MessageEncodingBindingElement, System.ServiceModel.Description.IWsdlExportExtension

type WebMessageEncodingBindingElement = class
    inherit MessageEncodingBindingElement
    interface IWsdlExportExtension

Public NotInheritable Class WebMessageEncodingBindingElement
Inherits MessageEncodingBindingElement
Implements IWsdlExportExtension

继承

Object

BindingElement

MessageEncodingBindingElement

WebMessageEncodingBindingElement

实现

IWsdlExportExtension

注解

编码是将消息转换为一个字节序列的过程。 解码是反向过程。 这些过程都需要字符编码规范。 WebMessageEncodingBindingElement 的工作方式是委托一系列内部编码器对纯文本 XML 与 JSON 编码以及“原始”二进制数据进行处理。 委托由复合消息编码器来完成。

在不使用 SOAP 消息（由 WebHttpBinding 使用）的方案中，用该绑定元素及其复合编码器控制编码。 这些方案包括“纯旧式 XML”(POX)、具象状态传输 (REST)、真正简单的整合 (RSS) 与 Atom 整合以及异步 JavaScript 和 XML (AJAX)。 复合消息编码器不支持 SOAP 或 WS-Addressing，因此，MessageVersion 总是返回 None。

在使用 WebMessageEncodingBindingElement(Encoding) 构造函数进行构造时可以使用编写字符编码配置绑定元素。 Encoding 值指定 JSON 与文本 XML 情况的编写行为。 在读取时，将理解任何有效的消息编码与文本编码。

此构造函数对分配给池的读取器和编写器的最大数量设置默认值，这两个默认值在未分配新的读取器和编写器时分别可用于处理传入和传出消息。 属性 MaxReadPoolSize 与 MaxWritePoolSize 也可以分别用来设置要分配的读取器和编写器最大数目。 默认情况下，将分配 64 个读取器和 16 个编写器。

此构造函数还可以通过 XmlDictionaryReaderQuotas 属性设置对与此编码关联的 ReaderQuotas 的默认复杂性约束，以抵御某种类型的拒绝服务 (DOS) 攻击，这些攻击试图利用消息复杂性来占用终结点处理资源。

WebMessageEncodingBindingElement 含有可以创建消息编码器工厂的 CreateMessageEncoderFactory 方法，该消息编码器工厂会根据指定的内容类型按需生成 JSON、XML 或原始消息解码器与编码器。

WebMessageEncodingBindingElement 还可以提供针对 HTTP 请求流过的通道生成工厂与侦听器的方法。

复合编码器及其关联的类和配置组件在部分信任中可用，这种使用无需任何特殊权限。