CookieContainer.Add 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
將 a Cookie 加到 CookieContainer。
多載
| 名稱 | Description |
|---|---|
| Add(Cookie) |
將 a Cookie 加到 CookieContainer。 此方法使用來自 的 Cookie 網域來決定要 Cookie 關聯哪個網域集合。 |
| Add(CookieCollection) |
將 a CookieCollection 的內容加到 CookieContainer。 |
| Add(Uri, Cookie) |
為特定 URI 加上 a CookieCookieContainer 。 |
| Add(Uri, CookieCollection) |
將特定 URI 的 a 內容 CookieCollection 加到 a CookieContainer 。 |
Add(Cookie)
將 a Cookie 加到 CookieContainer。 此方法使用來自 的 Cookie 網域來決定要 Cookie 關聯哪個網域集合。
public:
void Add(System::Net::Cookie ^ cookie);public void Add(System.Net.Cookie cookie);member this.Add : System.Net.Cookie -> unitPublic Sub Add (cookie As Cookie)參數
- cookie
- Cookie
Cookie將 加入 CookieContainer。
例外狀況
cookie 是 null。
定義 cookie 域為 null 空字串（“”）。
備註
若Count屬性等於或超過該Capacity性質，則在加入Cookie參數前會從容器中移除一個或多個cookie實例。 移除的實Cookie例數量足以如下CountCapacity：如果在指定範圍內有過期實例，則會被清理。 如果沒有，則會找到使用較少的 CookieCollection 那個，並從容器中移除。
另請參閱
適用於
Add(CookieCollection)
將 a CookieCollection 的內容加到 CookieContainer。
public:
void Add(System::Net::CookieCollection ^ cookies);public void Add(System.Net.CookieCollection cookies);member this.Add : System.Net.CookieCollection -> unitPublic Sub Add (cookies As CookieCollection)參數
- cookies
- CookieCollection
例外狀況
cookies 是 null。
備註
若屬性Count等於屬性，Capacity則在加入參數內容Cookie前，會先從容器中移除一個或多個cookies實例。 移除的實 Cookie 例數量足以騰出空間： cookies 若有過期實例，則會被清理。 如果沒有，或需要更多空間，則會找到使用最少的 CookieCollection 容器並從容器中移除。
另請參閱
適用於
Add(Uri, Cookie)
為特定 URI 加上 a CookieCookieContainer 。
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 -> unitPublic Sub Add (uri As Uri, cookie As Cookie)參數
- uri
- Uri
要加入的 URI Cookie 會加入 CookieContainer。
- cookie
- Cookie
Cookie將 加入 CookieContainer。
例外狀況
uri是null或cookie是。null
備註
如果你只為某個特定主機新增 Cookie 實例，請不要設定 Domain 該 Cookie 實例的屬性。 這是根據 URI 自動設定的。
如果你的 URI 對應到本地網域，並且傳送給當地所有主機，請將屬性設 Cookie.Domain 為「.local」。 否則，請確保它與 URI 中使用的主機名稱相符。
若 Version 的 Cookie 屬性為 Netscape，則 Path 的屬性 Cookie若未明確設定，則是從 URI 衍生而來，且是從 URI 完整路徑，包括頁面名稱。
若屬性Count等於屬性，Capacity則在加入Cookie參數前會從容器中移除一個或多個cookie實例。 移除的實Cookie例數量足以如下CountCapacity：如果範圍內有過期實例，會被清理。 如果沒有，則會找到使用較少的 CookieCollection 那個，並從容器中移除。
另請參閱
適用於
Add(Uri, CookieCollection)
將特定 URI 的 a 內容 CookieCollection 加到 a 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 -> unitPublic Sub Add (uri As Uri, cookies As CookieCollection)參數
- uri
- Uri
要加入的 URI CookieCollection 會加入 CookieContainer。
- cookies
- CookieCollection
例外狀況
cookies 是 null。
其中 cookies 一個 cookie 的網域是 null。
其中一個 cookie cookies 包含無效網域。
備註
如果你只為某個特定主機新增 Cookie 實例，請不要設定 Domain 該 Cookie 實例的屬性。 這是根據 URI 自動設定的。
如果你的 URI 對應到本地網域，並且傳送給當地所有主機，請將屬性設 CookieDomain 為「.local」。 否則，請確保它與 URI 中使用的主機名稱相符。
若Count等於 Capacity，則在加入Cookie參數前會先從容器中移除一個或多個cookie實例。 移除的實Cookie例數量足夠，如下CountCapacity：如果範圍內有過期實例，則會被清理。 如果沒有，則會找到使用較少的 CookieCollection 那個，並從容器中移除。
