HttpCookie(String, String, String) 构造函数

定义

命名空间:

Windows.Web.Http

使用指定的名称、域和路径初始化 HttpCookie 类的新实例。

public:
 HttpCookie(Platform::String ^ name, Platform::String ^ domain, Platform::String ^ path);

 HttpCookie(winrt::hstring const& name, winrt::hstring const& domain, winrt::hstring const& path);

public HttpCookie(string name, string domain, string path);

function HttpCookie(name, domain, path)

Public Sub New (name As String, domain As String, path As String)

参数

name

String

Platform::String

winrt::hstring

HttpCookie 的名称

domain

String

Platform::String

winrt::hstring

HttpCookie 对其有效的域。

path

String

Platform::String

winrt::hstring

应用 HttpCookie 的 URI。

注解

无法将 HttpCookie 的 name 参数设置为 null， (Visual Basic) 中无任何内容。

属性应该是 RFC 2616 和 RFC 6265 中定义的标记。

以下字符用作分隔符，不能在 name 参数中使用：

• left paren (' (')
• right paren (') ')
• 大于 ('>')
• 小于 ('<')
• at sign ('@')
• 逗号 ('，')
• 分号 (';')
• 冒号 ('：')
• 反斜杠 ('\')
• 双引号 ('“')
• 正斜杠 ('/')
• 左方括号 ('[')
• 右方括号 (']')
• 问号 ('？)
• 等号 ('=')
• 左波浪括号 ('{')
• 右波浪括号 ('}')
• 新行 ('\n')
• return ('\r“)
• space (“)
• tab ('\t“)

*domain * 参数指定将向其发送 HttpCookie 的主机。 *domain * 参数为 的 .contoso.com Cookie 将发送到 contoso.com 域，所有子域 (www.contoso.com 和 info.contoso.com，例如) 。

*domain * 参数为 的 info.contoso.com Cookie 不会发送到 contoso.com 或 www.contoso.com，但会发送到 info.contoso.com 所有子域 (uk.info.contoso.com 和 us.info.contoso.com，例如) 。

如果未指定 域 参数，则 HttpCookie 将仅发送到从中接收此 Cookie 的主机和子域。

path 参数指定此 HttpCookie 应用于的源服务器上的路径子集。 如果未指定此参数，则默认路径与任何路径匹配，并且 HttpCookie 将针对所有 HTTP 请求发送到指定的 *domain * 参数和所有子域。