Cookie 构造函数

定义

初始化 Cookie 类的新实例。 通常,应用程序无需构造 Cookie 类,因为该类会基于通过 HTTP 响应接收的 Set-Cookie 标头自动创建。

重载

Cookie()

初始化 Cookie 类的新实例。

Cookie(String, String)

使用指定的 CookieName 初始化 Value 类的新实例。

Cookie(String, String, String)

使用指定的 NameValuePath 初始化 Cookie 类的新实例。

Cookie(String, String, String, String)

使用指定的 NameValuePathDomain 初始化 Cookie 类的新实例。

Source:
Cookie.cs
Source:
Cookie.cs
Source:
Cookie.cs

初始化 Cookie 类的新实例。

public:
 Cookie();
public Cookie ();
Public Sub New ()

注解

无参数构造函数使用 、、 和 domain的空字符串 (“”) 将所有字段初始化为pathnamevalue默认值。 请注意, Name 在使用 类的 Cookie 实例之前,至少必须初始化 属性。

适用于

Source:
Cookie.cs
Source:
Cookie.cs
Source:
Cookie.cs

使用指定的 CookieName 初始化 Value 类的新实例。

public:
 Cookie(System::String ^ name, System::String ^ value);
public Cookie (string name, string value);
public Cookie (string name, string? value);
new System.Net.Cookie : string * string -> System.Net.Cookie
Public Sub New (name As String, value As String)

参数

name
String

Cookie 的名称。 不能在 name 中使用下列字符:等号、分号、逗号、换行符 (\n)、回车符 (\r)、制表符 (\t) 和空格字符。 货币符号 ($) 不能作为第一个字符。

value
String

Cookie 的值。 下列字符不得用在 value 中:分号、逗号。

例外

name 参数为 null

- 或 -

name 参数的长度为零。

- 或 -

name 参数包含无效字符。

- 或 -

value 参数为 null

- 或 -

value 参数包含一个未使用引号引起来的字符串,且该字符串中包含无效字符。

注解

参数的 value 默认值使用空字符串 (“”) 。

value 参数 Cookie 不能是 null Visual Basic) 中无任何 (引用。 分号 (“;”) 和逗号 (“,”) 字符是保留的,不能在参数中 value 传递,除非参数中 value 传递的字符串用双引号引起来。 因此,以下示例构造函数会成功,但当你尝试使用 Add(Cookie)Add(Uri, Cookie) 方法将此CookieCookieContainer添加到实例时,操作将失败并引发异常:

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "123,456");
cookie.Domain = "contoso.com";
new CookieContainer().Add(cookie);

但是,具有这些特殊字符转义的以下构造函数将创建 Cookie 可以添加到实例的 CookieContainer

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "\"123,456\"");
cookie.Domain = "contoso.com";
new CookieContainer().Add(cookie);

逗号字符用作同一行上单独的 Cookie 之间的分隔符。

另请参阅

适用于

Source:
Cookie.cs
Source:
Cookie.cs
Source:
Cookie.cs

使用指定的 NameValuePath 初始化 Cookie 类的新实例。

public:
 Cookie(System::String ^ name, System::String ^ value, System::String ^ path);
public Cookie (string name, string value, string path);
public Cookie (string name, string? value, string? path);
new System.Net.Cookie : string * string * string -> System.Net.Cookie
Public Sub New (name As String, value As String, path As String)

参数

name
String

Cookie 的名称。 不能在 name 中使用下列字符:等号、分号、逗号、换行符 (\n)、回车符 (\r)、制表符 (\t) 和空格字符。 货币符号 ($) 不能作为第一个字符。

value
String

Cookie 的值。 下列字符不得用在 value 中:分号、逗号。

path
String

Cookie 适用于的源服务器上的 URI 的子集。 默认值为“/”。

例外

name 参数为 null

- 或 -

name 参数的长度为零。

- 或 -

name 参数包含无效字符。

- 或 -

value 参数为 null

- 或 -

value 参数包含一个未使用引号引起来的字符串,且该字符串中包含无效字符。

注解

参数的 path 默认值使用空字符串 (“”) 。

value 参数 Cookie 不能是 null Visual Basic) 中无任何 (引用。 分号 (“;”) 和逗号 (“,”) 字符是保留的,不能在参数中 value 传递,除非参数中 value 传递的字符串用双引号引起来。 因此,以下示例构造函数会成功,但当你尝试使用 Add(Cookie)Add(Uri, Cookie) 方法将此CookieCookieContainer添加到实例时,操作将失败并引发异常:

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "123,456", "");
cookie.Domain = "contoso.com";
new CookieContainer().Add(cookie);

但是,具有这些特殊字符转义的以下构造函数将创建 Cookie 可以添加到实例的 CookieContainer

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "\"123,456\"", "");
cookie.Domain = "contoso.com";
new CookieContainer().Add(cookie);

逗号字符用作同一行上单独的 Cookie 之间的分隔符。

另请参阅

适用于

Source:
Cookie.cs
Source:
Cookie.cs
Source:
Cookie.cs

使用指定的 NameValuePathDomain 初始化 Cookie 类的新实例。

public:
 Cookie(System::String ^ name, System::String ^ value, System::String ^ path, System::String ^ domain);
public Cookie (string name, string value, string path, string domain);
public Cookie (string name, string? value, string? path, string? domain);
new System.Net.Cookie : string * string * string * string -> System.Net.Cookie
Public Sub New (name As String, value As String, path As String, domain As String)

参数

name
String

Cookie 的名称。 不能在 name 中使用下列字符:等号、分号、逗号、换行符 (\n)、回车符 (\r)、制表符 (\t) 和空格字符。 货币符号 ($) 不能作为第一个字符。

value
String

Cookie 对象的值。 下列字符不得用在 value 中:分号、逗号。

path
String

Cookie 适用于的源服务器上的 URI 的子集。 默认值为“/”。

domain
String

Cookie 对其有效的可选 Internet 域。 默认值为已从其中接收到此 Cookie 的主机。

例外

name 参数为 null

- 或 -

name 参数的长度为零。

- 或 -

name 参数包含无效字符。

- 或 -

value 参数为 null

- 或 -

value 参数包含一个未使用引号引起来的字符串,且该字符串中包含无效字符。

注解

path 参数的domain默认值使用空字符串 (“”) 。

value 参数 Cookie 不能是 null Visual Basic) 中无任何 (引用。 分号 (“;”) 和逗号 (“,”) 字符是保留的,不能在参数中 value 传递,除非参数中 value 传递的字符串用双引号引起来。 因此,以下示例构造函数会成功,但当你尝试使用 Add(Cookie)Add(Uri, Cookie) 方法将此CookieCookieContainer添加到实例时,操作将失败并引发异常:

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "123,456", "", "contoso.com");
new CookieContainer().Add(cookie);

但是,具有这些特殊字符转义的以下构造函数将创建 Cookie 可以添加到实例的 CookieContainer

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "\"123,456\"", "", "contoso.com");
new CookieContainer().Add(cookie);

逗号字符用作同一行上单独的 Cookie 之间的分隔符。

另请参阅

适用于