HttpCookie 类

  • 参考

定义

命名空间:
Windows.Web.Http
编辑

提供一组用于管理 HTTP Cookie 的属性和方法。

public ref class HttpCookie sealed : IStringable
/// [Windows.Foundation.Metadata.Activatable(Windows.Web.Http.IHttpCookieFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class HttpCookie final : IStringable
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Web.Http.IHttpCookieFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class HttpCookie final : IStringable
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Web.Http.IHttpCookieFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class HttpCookie : IStringable
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Web.Http.IHttpCookieFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class HttpCookie : IStringable
function HttpCookie(name, domain, path)
Public NotInheritable Class HttpCookie
Implements IStringable
继承
Object Platform::Object IInspectable HttpCookie
属性
ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute
实现
IStringable

Windows 要求

设备系列
Windows 10 (在 10.0.10240.0 中引入)
API contract
Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

注解

Cookie 是在 HTTP 服务器和客户端之间传递的小块数据。 Web 服务器开发人员的主要用途是保存会话状态。 Web 服务器开发人员使用 状态来关联之前和以后的请求。 例如，会话状态可以包含唯一的访问者 ID，该 ID 随后用于记住服务器端 () 访问者的购物车。

HTTP 服务器使用 Set-Cookie 标头将 Cookie 发送到客户端。 客户端使用 Cookie 标头发送回它们。 发送回的 Cookie 不包括 Cookie 属性。 正确的 Cookie 用法是服务器设置 Cookie 一次，不会在后续响应中重新设置它。 这之所以有效，是因为一旦设置 Cookie，就会发送回它，直到它过期或删除 (只要它与 URI 正确匹配) 。 Cookie 在具有有效的 Expires 标头时是永久性的。 非持久性 Cookie 是会话 Cookie，不会从一个会话保存到另一个会话。

尽管 Web 服务开发人员经常使用 Cookie，但客户端开发人员有时会使用它们。

构造函数

HttpCookie(String, String, String)

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

属性

Domain

获取 对其有效的 HttpCookie 的域。
Expires

获取或设置 HttpCookie 的到期日期和时间。
HttpOnly

获取或设置一个值，该值控制脚本或其他活动内容是否可以访问此 HttpCookie。
Name

获取表示 HttpCookie 名称的令牌。
Path

获取应用 HttpCookie 的 URI 路径组件。
Secure

获取或设置 HttpCookie 的安全级别。
Value

获取或设置 HttpCookie 的值。

方法

ToString()

返回表示当前 HttpCookie 对象的字符串。

适用于

另请参阅