CookieContainer.Add 方法

定義

命名空間:

System.Net

組件:

System.Net.Primitives.dll

將 Cookie 加入至 CookieContainer。

多載

Add(Cookie)	將 Cookie 加入至 CookieContainer。 這個方法使用 Cookie 中的網域以決定要與 Cookie 關聯的網域集合。
Add(CookieCollection)	將 CookieCollection 的內容加入 CookieContainer。
Add(Uri, Cookie)	將 Cookie 加入至特定 URI 的 CookieContainer。
Add(Uri, CookieCollection)	將 CookieCollection 的內容加入至特定 URI 的 CookieContainer。

Add(Cookie)

來源:

CookieContainer.cs

將 Cookie 加入至 CookieContainer。 這個方法使用 Cookie 中的網域以決定要與 Cookie 關聯的網域集合。

public:
 void Add(System::Net::Cookie ^ cookie);

public void Add (System.Net.Cookie cookie);

member this.Add : System.Net.Cookie -> unit

Public Sub Add (cookie As Cookie)

參數

cookie

Cookie

要加入至 Cookie 的 CookieContainer。

例外狀況

ArgumentNullException

cookie 為 null。

ArgumentException

cookie 的網域為 null 或空字串 ("")。

CookieException

cookie 大於 maxCookieSize。

-或-

cookie 的網域不是有效的 URI。

備註

Count如果屬性等於或超過 Capacity 屬性，在新增 cookie 參數之前，會先從容器中移除一或多個Cookie實例。 已移除足夠的Cookie實例，以如下所示：CapacityCount如果指定範圍中有過期的實例，則會加以清除。 如果沒有，則會從容器中找到最近使用的 CookieCollection 最少專案並加以移除。

另請參閱

• Cookie
• CookieCollection
• CookieContainer
• CookieException

Add(CookieCollection)

來源:

CookieContainer.cs

將 CookieCollection 的內容加入 CookieContainer。

public:
 void Add(System::Net::CookieCollection ^ cookies);

public void Add (System.Net.CookieCollection cookies);

member this.Add : System.Net.CookieCollection -> unit

Public Sub Add (cookies As CookieCollection)

參數

cookies

CookieCollection

要加入至 CookieCollection 的 CookieContainer。

例外狀況

ArgumentNullException

cookies 為 null。

備註

Count如果屬性等於 Capacity 屬性，在新增 參數的內容cookies之前，會先從容器中移除一或多個Cookie實例。 已移除足夠的 Cookie 實例，以便空間供 cookies 使用，如下所示：如果有過期的實例，則會清除這些實例。 如果沒有，或如果需要更多空間，則會找到最近使用 CookieCollection 最少的空間，並從容器中移除。

另請參閱

• Cookie
• CookieCollection
• CookieContainer
• CookieException

Add(Uri, Cookie)

來源:

CookieContainer.cs

將 Cookie 加入至特定 URI 的 CookieContainer。

public:
 void Add(Uri ^ uri, System::Net::Cookie ^ cookie);

public void Add (Uri uri, System.Net.Cookie cookie);

member this.Add : Uri * System.Net.Cookie -> unit

Public Sub Add (uri As Uri, cookie As Cookie)

參數

uri

Uri

要加入至 Cookie 之 CookieContainer 的 URI。

cookie

Cookie

要加入至 Cookie 的 CookieContainer。

例外狀況

ArgumentNullException

uri 是 null，或 cookie 是 null。

CookieException

cookie 大於 maxCookieSize。

-或-

cookie 的網域不是有效的 URI。

備註

如果您 Cookie 只新增一個特定主機的實例，請勿設定 Domain 實例的 Cookie 屬性。 這會根據 URI 自動設定。

如果您的 URI 對應至本機網域，並傳送至本機網域上的所有主機，請將 屬性設定 CookieDomain 為等於 “.local”。 否則，請確定它符合 URI 中使用的主機名。

Version如果 的 Cookie 屬性是 Netscape，Path則 如果未明確設定 ，則 的 Cookie屬性會衍生自 URI，而且是 URI 的完整路徑，包括頁面名稱。

Count如果屬性等於 Capacity 屬性，在新增 cookie 參數之前，會先從容器中移除一或多個Cookie實例。 已移除足夠的Cookie實例，以如下所示：CapacityCount如果範圍內有過期的實例，則會加以清除。 如果沒有，則會從容器中找到最近使用的 CookieCollection 最少專案並加以移除。

另請參閱

• Cookie
• CookieCollection
• CookieContainer
• CookieException

Add(Uri, CookieCollection)

來源:

CookieContainer.cs

將 CookieCollection 的內容加入至特定 URI 的 CookieContainer。

public:
 void Add(Uri ^ uri, System::Net::CookieCollection ^ cookies);

public void Add (Uri uri, System.Net.CookieCollection cookies);

member this.Add : Uri * System.Net.CookieCollection -> unit

Public Sub Add (uri As Uri, cookies As CookieCollection)

參數

uri

Uri

要加入至 CookieCollection 之 CookieContainer 的 URI。

cookies

CookieCollection

要加入至 CookieCollection 的 CookieContainer。

例外狀況

ArgumentNullException

cookies 為 null。

ArgumentException

cookies 內其中一個 Cookie 的網域是 null。

CookieException

cookies 內其中一個 Cookie 包含無效的網域。

備註

如果您 Cookie 只新增一個特定主機的實例，請勿設定 Domain 實例的 Cookie 屬性。 這會根據 URI 自動設定。

如果您的 URI 對應至本機網域，並傳送至本機網域上的所有主機，請將 屬性設定 CookieDomain 為等於 “.local”。 否則，請確定它符合 URI 中使用的主機名。

如果 Count 等於 Capacity，則在新增 cookie 參數之前，會先從容器中移除一或多個Cookie實例。 已移除足夠的Cookie實例，以如下所示：CapacityCount如果範圍中有過期的實例，則會加以清除。 如果沒有，則會從容器中找到最近使用的 CookieCollection 最少專案並加以移除。

另請參閱

• Cookie
• CookieCollection
• CookieContainer
• CookieException