BinaryMessageEncodingBindingElement.MaxSessionSize Property

Definition

Namespace:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Package:

System.ServiceModel.Primitives v8.0.0

Source:

BinaryMessageEncodingBindingElement.cs

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

public:
 property int MaxSessionSize { int get(); void set(int value); };

public int MaxSessionSize { get; set; }

member this.MaxSessionSize : int with get, set

Public Property MaxSessionSize As Integer

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

be.MaxSessionSize = 2048;

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.