WebMessageEncodingBindingElement Constructor (Encoding)

Initializes a new instance of the WebMessageEncodingBindingElement class with a specified write character encoding.

Namespace:  System.ServiceModel.Channels
Assembly:  System.ServiceModel.Web (in System.ServiceModel.Web.dll)

public WebMessageEncodingBindingElement(
	Encoding writeEncoding
)

Parameters

writeEncoding
Type: System.Text.Encoding

The Encoding to be used to write characters in a message.

ExceptionCondition
ArgumentNullException

writeEncoding is null.

ArgumentException

writeEncoding is not a supported message text encoding.

The message text encodings supported are UTF-8, Unicode, and Big-Endian Unicode. If another text encoding is specified, an ArgumentException is thrown.

This constructor sets default values on the maximum number of readers and writers that are allocated to pools and that are respectively available to process incoming and outgoing messages without allocating new readers or writers. There are 64 readers allocated by default for the MaxReadPoolSize property and there are 16 writers allocated by default for the MaxWritePoolSize property.

Default complexity constraints are also set by this constructor on the XmlDictionaryReaderQuotas associated with this message encoding by the ReaderQuotas property to protect against a class of denial of service (DOS) attacks that attempt to use message complexity to tie up endpoint processing resources. The properties that express these constraints and their default values (in bytes) are as follows:

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2015 Microsoft