WebMessageEncodingElement 类

定义

命名空间:

System.ServiceModel.Configuration

程序集:

System.ServiceModel.Web.dll

表示配置元素，该元素指定用于非 SOAP 消息的字符编码。 此类不能被继承。

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

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

type WebMessageEncodingElement = class
    inherit BindingElementExtensionElement

Public NotInheritable Class WebMessageEncodingElement
Inherits BindingElementExtensionElement

继承

Object

ConfigurationElement

ServiceModelConfigurationElement

ServiceModelExtensionElement

BindingElementExtensionElement

WebMessageEncodingElement

示例

using System;  
using System.Text;  
using System.ServiceModel;  
using System.ServiceModel.Web;  
using System.ServiceModel.Configuration;  

class Program  
{  
  static void Main(string[] args)  
  {  
      WebMessageEncodingElement webMEE = new WebMessageEncodingElement();  
      Console.WriteLine("The BE type is: {0}", webMEE.BindingElementType);  

      int maxReadPoolSize = webMEE.MaxReadPoolSize;  
      Console.WriteLine("The MaxReadPoolSize is: {0}", maxReadPoolSize);  
      maxReadPoolSize = 128;  
      Console.WriteLine("The MaxReadPoolSize has been changed to: {0}", maxReadPoolSize);  

      int maxWritePoolSize = webMEE.MaxWritePoolSize;  
      Console.WriteLine("The MaxWritePoolSize is: {0}", maxWritePoolSize);  
      maxWritePoolSize = 48;  
      Console.WriteLine("The MaxWritePoolSize has been changed to: {0}", maxWritePoolSize);  

      Encoding webMessageEncoding = webMEE.WriteEncoding;  
      Console.WriteLine("The write encoding is: {0}", webMessageEncoding);  
      webMessageEncoding = UnicodeEncoding.Unicode;  
      Console.WriteLine("The write encoding has been changed to: {0}", webMessageEncoding);  

      XmlDictionaryReaderQuotasElement webMessageReaderQuotasElement = webMEE.ReaderQuotas;  
      Console.WriteLine("The max depth of the reader Quotas is: {0}", webMessageReaderQuotasElement.MaxDepth);  

      Console.WriteLine("Press <ENTER> to terminate the program.");  
      Console.ReadLine();  
        }  
    }  

注解

编码是将一组 Unicode 字符转换为一个字节序列的过程。 非 SOAP 消息的编码类型是文本、JSON 和原始。

WebMessageEncodingElement 可表示配置中的 WebMessageEncodingBindingElement。 WebMessageEncodingBindingElement提供用于插入复合编码器的扩展点，该扩展点可用于替代传入消息内容类型如何映射到各种内部编码器， (文本/JSON/原始二进制) 由 Windows Communication Foundation (WCF) 提供。 复合消息编码器不支持 SOAP 或 WS-Addressing。

构造函数

WebMessageEncodingElement()

初始化 WebMessageEncodingElement 类的新实例。

属性

BindingElementType	获取此配置元素所启用的绑定元素的类型。
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	获取或设置一个值，该值指定无需分配新编写器便可同时发送的最大消息数。
Properties	获取属性的集合。 (继承自 ConfigurationElement)
ReaderQuotas	获取或设置可由配置了此绑定的终结点处理的 SOAP 消息的复杂性约束。
WebContentTypeMapperType	获取或设置 WebContentTypeMapper 的类型名称，该映射器指定传入消息的内容类型要映射到的格式。
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)