CookieContainer 类

定义

命名空间:

System.Net

程序集:

System.Net.Primitives.dll

Source:

CookieContainer.cs

为 CookieCollection 对象的集合提供容器。

public ref class CookieContainer

public class CookieContainer

type CookieContainer = class

Public Class CookieContainer

继承

Object

CookieContainer

注解

是 CookieContainer 一种数据结构，它为 类的 Cookie 实例提供存储，并以类似于数据库的方式进行访问。 具有 CookieContainer 容量限制，该限制是在由 属性创建或更改容器时设置的。

类的 Cookie 实例将基于其原始 URI 添加到容器中。 它将添加到与 URI 关联的内部 CookieCollection 。 Cookie基于 URI 从容器中检索为 CookieCollection，或作为可用于提交 HTTP WebRequest 的字符串。

有 CookieContainer 三个控制容器内容卷的属性： Capacity、 MaxCookieSize和 PerDomainCapacity。 这些值的默认设置分别为 300、4096 和 20。 Cookie将 添加到容器时，这些属性用于确定是否Cookie应放弃 已包含在 中的 CookieContainer ，以便为新容器腾出空间。 会CookieContainer跟踪每个添加，以确保既没有超出 限制，也没有CapacityPerDomainCapacity超出限制。 如果超过其中一个或两个，则 Cookie 删除 由 CookieContainer 保留的实例。 首先，删除任何过期 Cookie 项。 如果必须重新捕获更多容量，则会清除最近使用 CookieCollection 最少的容量。

构造函数

CookieContainer()	初始化 CookieContainer 类的新实例。
CookieContainer(Int32)	使用指定的表示容器可以包含的 CookieContainer 实例数的值初始化 Cookie 类的新实例。
CookieContainer(Int32, Int32, Int32)	使用指定属性初始化 CookieContainer 类的新实例。

字段

DefaultCookieLengthLimit	表示 Cookie 可以包含的 CookieContainer 实例的默认最大大小（以字节为单位）。 此字段为常数。
DefaultCookieLimit	表示 Cookie 可以包含的 CookieContainer 实例的默认最大数目。 此字段为常数。
DefaultPerDomainCookieLimit	表示 Cookie 可以在每个域引用的 CookieContainer 实例的默认最大数目。 此字段为常数。

属性

Capacity	获取或设置 CookieContainer 可以包含的 Cookie 实例数。
Count	获取 Cookie 当前包含的 CookieContainer 实例数。
MaxCookieSize	表示 Cookie 的最大允许长度。
PerDomainCapacity	获取或设置 CookieContainer 可以在每个域包含的 Cookie 实例数。

方法

Add(Cookie)	将 Cookie 添加到 CookieContainer。 此方法使用 Cookie 中的域来确定将 Cookie 与哪个域集合相关联。
Add(CookieCollection)	将 CookieCollection 的内容添加到 CookieContainer 中。
Add(Uri, Cookie)	将 Cookie 添加到特定 URI 的 CookieContainer 中。
Add(Uri, CookieCollection)	将 CookieCollection 的内容添加到特定 URI 的 CookieContainer 中。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetAllCookies()	获取一个 CookieCollection ，它包含 Cookie 容器中的所有实例。
GetCookieHeader(Uri)	获取 HTTP Cookie 标头，该标头包含表示与特定 URI 关联的 Cookie 实例的 HTTP Cookie。
GetCookies(Uri)	获取包含与特定 URI 关联的 CookieCollection 实例的 Cookie。
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
SetCookies(Uri, String)	将 HTTP Cookie 标头中的一个或多个 Cookie 的 Cookie 实例添加到特定 URI 的 CookieContainer 中。
ToString()	返回表示当前对象的字符串。 (继承自 Object)

另请参阅

• Cookie
• CookieCollection
• CookieContainer
• CookieException
• ICollection