CookieHandler.Write 方法

定義

命名空間:

System.IdentityModel.Services

組件:

System.IdentityModel.Services.dll

寫了一塊餅乾。

多載

名稱	Description
Write(Byte[], Boolean, DateTime)	會寫入與當前請求相關聯的 Cookie，該 Cookie 具有指定的值、持久性及到期時間。
Write(Byte[], String, DateTime)	會寫入與當前請求相關聯的 Cookie，該 cookie 包含指定的名稱、值與到期時間。
Write(Byte[], String, DateTime, HttpContext)	會寫入與指定請求相關的 Cookie，該 Cookie 包含指定的名稱、值和到期時間。
Write(Byte[], String, String, String, DateTime, Boolean, Boolean, HttpContext)	會寫入與指定請求相關的 Cookie，該 Cookie 包含指定的名稱、值、網域、路徑、到期時間及可見性。

Write(Byte[], Boolean, DateTime)

會寫入與當前請求相關聯的 Cookie，該 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[]

餅乾的價值。

isPersistent

Boolean

true 如果 cookie 是持久性的; false 如果 Cookie 是僅限會話時，也就是說，只有在客戶端的瀏覽器關閉前才有效。

tokenExpirationTime

DateTime

底層代幣的到期時間。

例外狀況

ArgumentNullException

value 是 null 或空的。

備註

若參數 isPersistent 為 false，則 cookie 到期時間設為 DateTime.MinValue。 若isPersistent參數為 true，則 cookie 到期時間設為PersistentSessionLifetime屬性值（若非），若PersistentSessionLifetime屬性null為 null，則 到期時間設為參數值tokenExpirationTime。

Cookie 名稱、網域與路徑由 Name、 Domain及 Path 屬性指定。 請求由 指定。Current 是否只透過 SSL 傳送 cookie，以及 RequireSsl 是否應該對用戶端腳本隱藏，則由屬性指定 HideFromClientScript 。

Write(Byte[], String, DateTime)

會寫入與當前請求相關聯的 Cookie，該 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[]

餅乾的價值。

name

String

餅乾的名字。

expirationTime

DateTime

cookie 的有效期限，或 DateTime.MinValue 用於會話（僅限會話）的 cookie。

例外狀況

ArgumentNullException

value 是 null 或空的。

ArgumentException

name 是 null 或空的。

備註

cookie 網域與路徑由 Domain and Path 屬性指定。 請求由 指定。HttpContext.Current 請求由 指定。Current 是否只透過 SSL 傳送 cookie，以及 RequireSsl 是否應該對用戶端腳本隱藏，則由屬性指定 HideFromClientScript 。

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

會寫入與指定請求相關的 Cookie，該 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[]

餅乾的價值。

name

String

餅乾的名字。

expirationTime

DateTime

cookie 的有效期限，或 DateTime.MinValue 用於會話（僅限會話）的 cookie。

context

HttpContext

那個 HttpContext 請求。

例外狀況

ArgumentNullException

value 是 null 或空的。

ArgumentException

name 是 null 或空的。

備註

cookie 網域與路徑由 Domain and Path 屬性指定。 請求由 指定。Current 是否只透過 SSL 傳送 cookie，以及 RequireSsl 是否應該對用戶端腳本隱藏，則由屬性指定 HideFromClientScript 。

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

會寫入與指定請求相關的 Cookie，該 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[]

餅乾的價值。

name

String

餅乾的名字。

path

String

餅乾的路徑。

domain

String

cookie 的網域。

expirationTime

DateTime

cookie 的有效期限，或 DateTime.MinValue 用於會話（僅限會話）的 cookie。

requiresSsl

Boolean

true如果 cookie 只能透過 SSL 連線使用;否則，。 false

hideFromClientScript

Boolean

true如果 cookie 應該對用戶端腳本隱藏;否則，。 false

context

HttpContext

那個 HttpContext 請求。

例外狀況

ArgumentNullException

value 是 null 或空的。

ArgumentException

name 是 null 或空的。