CookieContainer.Capacity Property

Definition

Gets or sets the number of Cookie instances that a CookieContainer can hold.

public:
 property int Capacity { int get(); void set(int value); };
public:
 property int Capacity { int get(); };
public int Capacity { get; set; }
public int Capacity { get; }
member this.Capacity : int with get, set
member this.Capacity : int
Public Property Capacity As Integer
Public ReadOnly Property Capacity As Integer

Property Value

The number of Cookie instances that a CookieContainer can hold. This is a hard limit and cannot be exceeded by adding a Cookie.

Exceptions

Capacity is less than or equal to zero or (value is less than PerDomainCapacity and PerDomainCapacity is not equal to Int32.MaxValue).

Remarks

If Count equals or exceeds Capacity, one or more Cookie instances are removed from the container. Enough instances are removed to bring Count below Capacity as follows: if there are expired Cookie instances in scope, they are cleaned up. If not, then the least recently used CookieCollection is found and removed from the container.

Capacity must be greater than or equal to PerDomainCapacity.

Applies to

See also