CookieContainer.Capacity Property

Definition

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

C#
public int Capacity { get; set; }
C#
public int Capacity { get; }

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

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.

Applies to

Product Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

See also