CookieContainer.Add 方法

  • 参考

定义

命名空间:
System.Net
程序集:
System.Net.Primitives.dll
程序集:
System.dll
程序集:
netstandard.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)

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

要添加到 Cookie 的 CookieContainer。

例外

ArgumentNullException

cookie 为 null。

ArgumentException

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

CookieException

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

要添加到 CookieCollection 的 CookieContainer。

例外

ArgumentNullException

cookies 为 null。

注解

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

要添加到 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的实例，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

要添加到 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实例，如下所示CountCapacity：如果范围内存在过期的实例，则会清理这些实例。 如果没有，则会找到最近使用 CookieCollection 最少的 ，并从容器中删除。

另请参阅

适用于