CookieContainer 類別

  • 參考

定義

命名空間:
System.Net
組件:
System.Net.Primitives.dll
組件:
System.dll
組件:
netstandard.dll

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

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 的字串，從容器擷取 。

CookieContainer有三個屬性可控管容器內容的磁片區： Capacity 、 MaxCookieSize 和 PerDomainCapacity 。 這些值分別具有 300、4096 和 20 的預設設定。 Cookie將 新增至容器時，會使用這些屬性來判斷 Cookie 是否應該捨棄 內含 的 CookieContainer ，以便為新的容器提供空間。 會 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)

適用於

另請參閱