Cookie 构造函数

定义

命名空间:

System.Net

程序集:

System.Net.Primitives.dll

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

重载

Cookie()	初始化 Cookie 类的新实例。
Cookie(String, String)	使用指定的 Cookie 和 Name 初始化 Value 类的新实例。
Cookie(String, String, String)	使用指定的 Name、Value 和 Path 初始化 Cookie 类的新实例。
Cookie(String, String, String, String)	使用指定的 Name、Value、Path 和 Domain 初始化 Cookie 类的新实例。

Cookie()

Source:

Cookie.cs

初始化 Cookie 类的新实例。

public:
 Cookie();

public Cookie ();

Public Sub New ()

注解

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

Cookie(String, String)

Source:

Cookie.cs

使用指定的 Cookie 和 Name 初始化 Value 类的新实例。

public:
 Cookie(System::String ^ name, System::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 中：分号、逗号。

例外

CookieException

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 之间的分隔符。

另请参阅

• CookieCollection
• CookieContainer
• CookieException

Cookie(String, String, String)

Source:

Cookie.cs

使用指定的 Name、Value 和 Path 初始化 Cookie 类的新实例。

public:
 Cookie(System::String ^ name, System::String ^ value, System::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 的子集。 默认值为“/”。

例外

CookieException

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 之间的分隔符。

另请参阅

• CookieCollection
• CookieContainer
• CookieException

Cookie(String, String, String, String)

Source:

Cookie.cs

使用指定的 Name、Value、Path 和 Domain 初始化 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);

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 的主机。

例外

CookieException

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 之间的分隔符。

另请参阅

• CookieCollection
• CookieContainer
• CookieException