Edit

WebHttpBindingElement.MaxBufferSize Property

  • Reference

Definition

Namespace:
System.ServiceModel.Configuration
Assembly:
System.ServiceModel.Web.dll

Gets or sets the maximum amount of memory, in bytes, that is allocated for use by the manager of the message buffers that receive messages from the channel.

public:
 property int MaxBufferSize { int get(); void set(int value); };
[System.Configuration.ConfigurationProperty("maxBufferSize", DefaultValue=65536)]
[System.Configuration.IntegerValidator(MinValue=1)]
public int MaxBufferSize { get; set; }
[<System.Configuration.ConfigurationProperty("maxBufferSize", DefaultValue=65536)>]
[<System.Configuration.IntegerValidator(MinValue=1)>]
member this.MaxBufferSize : int with get, set
Public Property MaxBufferSize As Integer

Property Value

Int32

The maximum amount of memory, in bytes, available for use by the message buffer manager. The default value is 524,288 (0x80000) bytes.

Attributes
ConfigurationPropertyAttribute IntegerValidatorAttribute

Exceptions

ArgumentOutOfRangeException

The value set is less than or equal to zero.

Remarks

The BufferManager minimizes the cost of using buffers by using a buffer pool. Buffers are required to process messages by the service when they come out of the channel. If there is not sufficient memory in the buffer pool to process the message load, the BufferManager must allocate additional memory from the CLR heap, which increases the garbage collection overhead. Extensive allocation from the CLR garbage heap is an indication that the buffer pool size is too small and that performance can be improved with a larger allocation by increasing the MaxBufferPoolSize limit.

Applies to