CookieHandler.Write 方法

定义

写入 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

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

tokenExpirationTime
DateTime

基础标识的过期时间。

例外

valuenull 或空。

注解

isPersistent如果 参数为 false,则 Cookie 过期时间设置为 DateTime.MinValueisPersistent如果 参数为 true,则 Cookie 过期时间设置为 属性的值PersistentSessionLifetime(如果不是null),或者,如果该PersistentSessionLifetime属性为 null,则过期时间设置为 参数的值tokenExpirationTime

Cookie 名称、域和路径由 NameDomainPath 属性指定。 请求由 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 的过期时间,或会话的 DateTime.MinValue (仅限会话) Cookie。

例外

valuenull 或空。

namenull 或空。

注解

Cookie 域和路径由 DomainPath 属性指定。 请求由 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 的过期时间,或会话的 DateTime.MinValue (仅限会话) Cookie。

context
HttpContext

该请求的 HttpContext

例外

valuenull 或空。

namenull 或空。

注解

Cookie 域和路径由 DomainPath 属性指定。 请求由 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)

参数

value
Byte[]

Cookie 值。

name
String

Cookie 的名称。

path
String

Cookie的路径。

domain
String

Cookie 的域。

expirationTime
DateTime

cookie 的过期时间,或会话的 DateTime.MinValue (仅限会话) Cookie。

requiresSsl
Boolean

如果只应针对 SSL 连接使用 cookie,则为 true ;否则为 false

hideFromClientScript
Boolean

如果应隐藏客户脚本的 cookie,则为 true;否则为 false

context
HttpContext

该请求的 HttpContext

例外

valuenull 或空。

namenull 或空。

适用于