CookieHandler.Write 方法

定义

命名空间:: System.IdentityModel.Services

程序集:: System.IdentityModel.Services.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

写入 Cookie。

重载

名称	说明
Write(Byte[], Boolean, DateTime)	写入与具有指定值、持久性和过期时间的当前请求关联的 Cookie。
Write(Byte[], String, DateTime)	写入与具有指定名称、值和过期时间的当前请求关联的 Cookie。
Write(Byte[], String, DateTime, HttpContext)	写入与具有指定名称、值和过期时间的指定请求关联的 Cookie。
Write(Byte[], String, String, String, DateTime, Boolean, Boolean, HttpContext)	编写与具有指定名称、值、域、路径、过期时间和可见性的指定请求关联的 Cookie。

Write(Byte[], Boolean, DateTime)

写入与具有指定值、持久性和过期时间的当前请求关联的 Cookie。

public:
 void Write(cli::array <System::Byte> ^ value, bool isPersistent, DateTime tokenExpirationTime);

public void Write(byte[] value, bool isPersistent, DateTime tokenExpirationTime);

member this.Write : byte[] * bool * DateTime -> unit

Public Sub Write (value As Byte(), isPersistent As Boolean, tokenExpirationTime As DateTime)

参数

value: Byte[]

Cookie 值。

isPersistent: Boolean

true 如果 Cookie 是永久性的，则为 false 如果 Cookie 仅会话，即仅在客户端上的浏览器关闭之前有效。

tokenExpirationTime: DateTime

基础令牌的过期时间。

例外

ArgumentNullException

value 为 null 或为空。

注解

如果参数 isPersistent 为 false，则 Cookie 过期时间设置为 DateTime.MinValue。 isPersistent如果参数为true，则 Cookie 过期时间设置为属性的值PersistentSessionLifetime（如果不是null）或者，如果PersistentSessionLifetime属性为null，则过期时间设置为参数的值tokenExpirationTime。

Cookie 名称、域和路径由 <a0/> 和属性指定。请求由 Current. 是否应仅通过 SSL 发送 Cookie 由 RequireSsl 属性指定，以及是否应从客户端脚本隐藏 Cookie 由 HideFromClientScript 该属性指定。

适用于

Write(Byte[], String, DateTime)

写入与具有指定名称、值和过期时间的当前请求关联的 Cookie。

public:
 void Write(cli::array <System::Byte> ^ value, System::String ^ name, DateTime expirationTime);

public void Write(byte[] value, string name, DateTime expirationTime);

member this.Write : byte[] * string * DateTime -> unit

Public Sub Write (value As Byte(), name As String, expirationTime As DateTime)

参数

value: Byte[]

Cookie 值。

name: String

Cookie 的名称。

expirationTime: DateTime

Cookie 的过期时间，或会话（仅会话）Cookie 的 DateTime.MinValue 。

例外

ArgumentNullException

value 为 null 或为空。

ArgumentException

name 为 null 或为空。

注解

Cookie 域和路径由 Domain 属性 Path 指定。请求由 HttpContext.Current. 请求由 Current. 是否应仅通过 SSL 发送 Cookie 由 RequireSsl 属性指定，以及是否应从客户端脚本隐藏 Cookie 由 HideFromClientScript 该属性指定。

适用于

Write(Byte[], String, DateTime, HttpContext)

写入与具有指定名称、值和过期时间的指定请求关联的 Cookie。

public:
 void Write(cli::array <System::Byte> ^ value, System::String ^ name, DateTime expirationTime, System::Web::HttpContext ^ context);

public void Write(byte[] value, string name, DateTime expirationTime, System.Web.HttpContext context);

member this.Write : byte[] * string * DateTime * System.Web.HttpContext -> unit

Public Sub Write (value As Byte(), name As String, expirationTime As DateTime, context As HttpContext)

参数

value: Byte[]

Cookie 值。

name: String

Cookie 的名称。

expirationTime: DateTime

Cookie 的过期时间，或会话（仅会话）Cookie 的 DateTime.MinValue 。

context: HttpContext

请求 HttpContext 的编号。

例外

ArgumentNullException

value 为 null 或为空。

ArgumentException

name 为 null 或为空。

注解

Cookie 域和路径由 Domain 属性 Path 指定。请求由 Current. 是否应仅通过 SSL 发送 Cookie 由 RequireSsl 属性指定，以及是否应从客户端脚本隐藏 Cookie 由 HideFromClientScript 该属性指定。

适用于

Write(Byte[], String, String, String, DateTime, Boolean, Boolean, HttpContext)

编写与具有指定名称、值、域、路径、过期时间和可见性的指定请求关联的 Cookie。

public:
 void Write(cli::array <System::Byte> ^ value, System::String ^ name, System::String ^ path, System::String ^ domain, DateTime expirationTime, bool requiresSsl, bool hideFromClientScript, System::Web::HttpContext ^ context);

public void Write(byte[] value, string name, string path, string domain, DateTime expirationTime, bool requiresSsl, bool hideFromClientScript, System.Web.HttpContext context);

member this.Write : byte[] * string * string * string * DateTime * bool * bool * System.Web.HttpContext -> unit

Public Sub Write (value As Byte(), name As String, path As String, domain As String, expirationTime As DateTime, requiresSsl As Boolean, hideFromClientScript As Boolean, context As HttpContext)