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實例，以便如下所示CountCapacity：如果指定範圍中有過期的實例，則會清除這些實例。 如果沒有，則會從容器中找到最近使用的最少專案 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 屬性，則會先從容器移除一或多個Cookie實例，再新增 參數的內容cookies。 已移除足夠的 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特定主機的Cookie實例，請勿設定 Domain 實例的屬性。 這會根據 URI 自動設定。

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

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

Count如果 屬性等於 Capacity 屬性，在新增 cookie 參數之前，會先從容器中移除一或多個Cookie實例。 已移除足夠的Cookie實例，如下所示CountCapacity：如果範圍內有過期的實例，則會清除這些實例。 如果沒有，則會從容器中找到最近使用的最少專案 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特定主機的Cookie實例，請勿設定 Domain 實例的屬性。 這會根據 URI 自動設定。

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

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

另請參閱

• Cookie
• CookieCollection
• CookieContainer
• CookieException