CookieContainer.Capacity Property  
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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, setmember this.Capacity : intPublic Property Capacity As IntegerPublic ReadOnly Property Capacity As IntegerProperty 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
The capacity to set 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.