Cookie 构造函数

定义

命名空间:

System.Net

程序集:

System.Net.Primitives.dll

初始化 Cookie 类的新实例。 通常，应用程序不需要构造 Cookie 类，因为它是根据使用 HTTP 响应收到的 Set-Cookie 标头自动创建的。

重载

Cookie()	初始化 Cookie 类的新实例。
Cookie(String, String)	使用指定的 Name 和 Value初始化 Cookie 类的新实例。
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 ()

注解

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

Cookie(String, String)

Source:

Cookie.cs

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

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 参数的默认值使用空字符串（“）。

Cookie 的 value 参数不能是 null 引用（Visual Basic 中没有任何内容）。 分号 （“;”） 和逗号 （“，”） 字符是保留的，不能在 value 参数中传递，除非传入 value 参数的字符串括在双引号中。 因此，以下示例构造函数会成功，但尝试将此 Cookie 添加到具有 Add(Cookie) 或 Add(Uri, Cookie) 方法的 CookieContainer 实例时，操作将失败并引发异常：

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

但是，使用以下特殊字符转义的构造函数将创建可添加到 CookieContainer 实例的 Cookie：

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 参数的默认值使用空字符串（“）。

Cookie 的 value 参数不能是 null 引用（Visual Basic 中没有任何内容）。 分号 （“;”） 和逗号 （“，”） 字符是保留的，不能在 value 参数中传递，除非传入 value 参数的字符串括在双引号中。 因此，以下示例构造函数会成功，但尝试将此 Cookie 添加到具有 Add(Cookie) 或 Add(Uri, Cookie) 方法的 CookieContainer 实例时，操作将失败并引发异常：

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

但是，使用以下特殊字符转义的构造函数将创建可添加到 CookieContainer 实例的 Cookie：

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 参数包含的字符串不包含在引号中，其中包含无效字符。

注解

domain 和 path 参数的默认值使用空字符串（“）。

Cookie 的 value 参数不能是 null 引用（Visual Basic 中没有任何内容）。 分号 （“;”） 和逗号 （“，”） 字符是保留的，不能在 value 参数中传递，除非传入 value 参数的字符串括在双引号中。 因此，以下示例构造函数会成功，但尝试将此 Cookie 添加到具有 Add(Cookie) 或 Add(Uri, Cookie) 方法的 CookieContainer 实例时，操作将失败并引发异常：

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

但是，使用以下特殊字符转义的构造函数将创建可添加到 CookieContainer 实例的 Cookie：

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

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

另请参阅

• CookieCollection
• CookieContainer
• CookieException