CookieHandler.Write 方法

定义

命名空间:

System.IdentityModel.Services

程序集:

System.IdentityModel.Services.dll

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

基础标识的过期时间。

例外

ArgumentNullException

value 为 null 或空。

注解

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

Cookie 名称、域和路径由 Name、 Domain和 Path 属性指定。 请求由 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。

例外

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 的过期时间，或会话的 DateTime.MinValue (仅限会话) Cookie。

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)

参数

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。

例外

ArgumentNullException

value 为 null 或空。

ArgumentException

name 为 null 或空。