CookieContainer 类

定义

命名空间:

System.Net

程序集:

System.Net.Primitives.dll

程序集:

System.dll

程序集:

netstandard.dll

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

public ref class CookieContainer

public ref class CookieContainer sealed

public class CookieContainer

[System.Serializable]
public class CookieContainer

public sealed class CookieContainer

type CookieContainer = class

[<System.Serializable>]
type CookieContainer = class

Public Class CookieContainer

Public NotInheritable Class CookieContainer

继承

Object

CookieContainer

属性

SerializableAttribute

注解

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

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

有 CookieContainer 三个属性，用于控制容器内容的卷： Capacity、 MaxCookieSize和 PerDomainCapacity。 这些值分别具有 300、4096 和 20 的默认设置。 将 a Cookie 添加到容器时，这些属性用于确定是否应放弃已包含在容器CookieContainer中的属性Cookie，以便为新容器腾出空间。 跟踪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