CookieContainer 類別

定義

命名空間:

System.Net

組件:

System.Net.Primitives.dll

來源:

CookieContainer.cs

提供 CookieCollection 物件集合的容器 (Container)。

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 WebRequests 的字串。

CookieContainer有三個屬性可控管容器內容的磁碟區：Capacity、 MaxCookieSize和 PerDomainCapacity。 這些值分別具有 300、4096 和 20 的預設設定。 Cookie將 新增至容器時，會使用這些屬性來判斷 是否應該捨棄 內CookieContainer含的 Cookie ，以便為新的容器提供空間。 會 CookieContainer 持續追蹤每個新增專案，以確保不會 Capacity 超過 或 PerDomainCapacity 限制。 如果超過一或兩者，則會 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)	取得 CookieCollection，包含與特定 URI 關聯的 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