CookieContainer::Capacity Property

 

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

Namespace:   System.Net
Assembly:  System (in System.dll)

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

Property Value

Type: System::Int32

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

Exception Condition
ArgumentOutOfRangeException

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

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.

Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 3.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
Show: