CookieContainer 类

定义

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

为 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

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

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

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

CookieContainer()	初始化 CookieContainer 类的新实例。
CookieContainer(Int32, Int32, Int32)	使用特定属性初始化 CookieContainer 类的新实例。
CookieContainer(Int32)	使用容器可以保存的 Cookie 实例数指定值初始化 CookieContainer 类的新实例。

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

Capacity	获取或设置 CookieContainer 可以保留的 Cookie 实例数。
Count	获取 CookieContainer 当前保存的 Cookie 实例数。
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 的 HTTP Cookie 标头，这些 cookie 表示与特定 URI 关联的 Cookie 实例。
GetCookies(Uri)	获取一个 CookieCollection，其中包含与特定 URI 关联的 Cookie 实例。
GetHashCode()	用作默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object的浅表副本。 (继承自 Object)
SetCookies(Uri, String)	将一个或多个 Cookie 的 Cookie 实例从 HTTP Cookie 标头添加到特定 URI 的 CookieContainer。
ToString()	返回一个表示当前对象的字符串。 (继承自 Object)