CookieContainer.Add 方法

定义

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)

Source:
CookieContainer.cs
Source:
CookieContainer.cs
Source:
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

要添加到 CookieCookieContainer

例外

cookienull

cookie 的域为 null 或空字符串 ("")。

cookie 大于 maxCookieSize

- 或 -

cookie 的域不是有效的 URI。

注解

Count如果 属性等于或超过 属性Capacity,则会在添加 cookie 参数之前从容器中删除一个或多个Cookie实例。 删除了足够多Cookie的实例,CountCapacity如下所示:如果给定范围内存在过期的实例,则会清理这些实例。 如果没有,则会找到最近使用 CookieCollection 最少的 ,并从容器中删除。

另请参阅

适用于

Add(CookieCollection)

Source:
CookieContainer.cs
Source:
CookieContainer.cs
Source:
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

要添加到 CookieCollectionCookieContainer

例外

cookiesnull

注解

Count如果 属性等于 Capacity 属性,则在添加 参数的内容cookies之前,将从容器中删除一个或多个Cookie实例。 删除足够的 Cookie 实例,以便腾出空间 cookies ,如下所示:如果有过期的实例,则会清理它们。 如果没有,或者需要更多的空间,则会找到最近使用 CookieCollection 最少的容器并将其从容器中删除。

另请参阅

适用于

Add(Uri, Cookie)

Source:
CookieContainer.cs
Source:
CookieContainer.cs
Source:
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

要添加到 CookieCookieContainer 的 URI。

cookie
Cookie

要添加到 CookieCookieContainer

例外

urinullcookienull

cookie 大于 maxCookieSize

- 或 -

cookie 的域不是有效的 URI。

注解

如果仅为一个 Cookie 特定主机添加实例,请不要设置 Domain 实例的 Cookie 属性。 这会根据 URI 自动设置。

如果 URI 对应于本地域并发送到本地域上的所有主机,请将 CookieDomain 属性设置为“.local”。 否则,请确保它与 URI 中使用的主机名匹配。

Version如果 的 Cookie 属性为 Netscape,则 Path 的 属性Cookie(如果未显式设置)派生自 URI,并且是 URI 的完整路径,包括页面名称。

Count如果 属性等于 属性Capacity,则在添加 cookie 参数之前,将从容器中删除一个或多个Cookie实例。 删除了足够多Cookie的实例,CountCapacity如下所示:如果范围内存在过期的实例,则会清理这些实例。 如果没有,则会找到最近使用 CookieCollection 最少的 ,并从容器中删除。

另请参阅

适用于

Add(Uri, CookieCollection)

Source:
CookieContainer.cs
Source:
CookieContainer.cs
Source:
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

要添加到 CookieCollectionCookieContainer 的 URI。

cookies
CookieCollection

要添加到 CookieCollectionCookieContainer

例外

cookiesnull

cookies 中的某一个 Cookie 的域是 null

cookies 中的某一个 Cookie 包含无效的域。

注解

如果仅为一个 Cookie 特定主机添加实例,请不要设置 Domain 实例的 Cookie 属性。 这会根据 URI 自动设置。

如果 URI 对应于本地域并发送到本地域上的所有主机,请将 CookieDomain 属性设置为“.local”。 否则,请确保它与 URI 中使用的主机名匹配。

如果 Count 等于 Capacity,则在添加 cookie 参数之前,将从容器中删除一个或多个Cookie实例。 删除足够的Cookie实例,如下所示CountCapacity:如果范围内存在过期的实例,则会清理这些实例。 如果没有,则会找到最近使用 CookieCollection 最少的 ,并从容器中删除。

另请参阅

适用于