BinaryMessageEncodingBindingElement.MaxSessionSize Property

Definition

Namespace:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Package:

System.ServiceModel.Primitives v8.1.1

Source:

BinaryMessageEncodingBindingElement.cs

Gets or sets the maximum amount of memory available within a session for optimizing transmission procedures.

C#

public int MaxSessionSize { get; set; }

Property Value

Int32

The maximum size, in bytes, of a session. The default value is 2048 bytes.

Exceptions

ArgumentOutOfRangeException

The value is less than or equal to zero.

Examples

C#

be.MaxSessionSize = 2048;

Remarks

The .NET Binary Format for XML can optimize the transmission of strings when they are used in multiple messages within a session. Once a string is sent in a message, additional messages that contain that string can refer to it using only the string's ID. This requires that the strings and their IDs be stored in memory. This allows the ID to be retransmitted in subsequent messages instead of the entire string. This lookup increases the efficiency of message transmission when using the binary format. The MaxSessionSize gets and sets the maximum amount of memory that is allocated to store these strings.

Applies to