通过

WebMessageEncodingBindingElement 构造函数

  • 参考

定义

命名空间:
System.ServiceModel.Channels
程序集:
System.ServiceModel.Web.dll

初始化 WebMessageEncodingBindingElement 类的新实例。

重载

WebMessageEncodingBindingElement()

初始化 WebMessageEncodingBindingElement 类的新实例。
WebMessageEncodingBindingElement(Encoding)

使用指定的编写字符编码初始化 WebMessageEncodingBindingElement 类的新实例。

WebMessageEncodingBindingElement()

初始化 WebMessageEncodingBindingElement 类的新实例。

public:
 WebMessageEncodingBindingElement();
public WebMessageEncodingBindingElement ();
Public Sub New ()

注解

此构造函数将 UTF8Encoding 用作默认字符编码。 因此，如果要使用该字符编码，可以使用这个构造函数。 如果要使用其他字符编码，可以使用 WebMessageEncodingBindingElement(Encoding) 构造函数。

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

默认复杂性约束也由该构造函数在通过 XmlDictionaryReaderQuotas 属性与该消息编码关联的 ReaderQuotas 上进行设置，以防止某种类型的拒绝服务 (DOS) 攻击，这些攻击试图利用消息复杂性来占用终结点处理资源。 表示这些约束的属性及其默认值（以字节表示）如下所示：

适用于

WebMessageEncodingBindingElement(Encoding)

使用指定的编写字符编码初始化 WebMessageEncodingBindingElement 类的新实例。

public:
 WebMessageEncodingBindingElement(System::Text::Encoding ^ writeEncoding);
public WebMessageEncodingBindingElement (System.Text.Encoding writeEncoding);
new System.ServiceModel.Channels.WebMessageEncodingBindingElement : System.Text.Encoding -> System.ServiceModel.Channels.WebMessageEncodingBindingElement
Public Sub New (writeEncoding As Encoding)

参数

writeEncoding
Encoding

用于在消息中写入字符的 Encoding。

例外

ArgumentNullException

writeEncoding 为 null。

ArgumentException

不支持 writeEncoding 消息文本编码。

注解

支持 UTF-8、Unicode 与 Big-Endian Unicode 消息文本编码。 如果指定其他文本编码，则会引发 ArgumentException。

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

默认复杂性约束也由该构造函数在通过 XmlDictionaryReaderQuotas 属性与该消息编码关联的 ReaderQuotas 上进行设置，以防止某种类型的拒绝服务 (DOS) 攻击，这些攻击试图利用消息复杂性来占用终结点处理资源。 表示这些约束的属性及其默认值（以字节表示）如下所示：

适用于