FormsAuthentication.SetAuthCookie 方法

定義

命名空間:
System.Web.Security
組件:
System.Web.dll

為所提供的使用者名稱建立認證工單，並將其加入回應的 cookies 集合中，或若使用無 cookie 認證則加入網址。

多載

名稱 Description
SetAuthCookie(String, Boolean)

為所提供的使用者名稱建立認證工單，並將其加入回應的 cookies 集合中，或若使用無 cookie 認證則加入網址。
SetAuthCookie(String, Boolean, String)

為所提供的使用者名稱建立認證工單，並將其加入回應的 cookie 集合中，使用提供的 cookie 路徑，或若使用無 cookie 認證則使用 URL。

備註

此SetAuthCookie方法會在 cookies 集合或 若為 時false的 URL CookiesSupported 中加入表單驗證票。 表單認證單會提供表單認證資訊給瀏覽器下一次的請求。 透過表單認證，你可以在想要驗證使用者同時保留導覽控制權時使用 SetAuthCookie 這個方法。

SetAuthCookie(String, Boolean)

為所提供的使用者名稱建立認證工單，並將其加入回應的 cookies 集合中，或若使用無 cookie 認證則加入網址。

public:
 static void SetAuthCookie(System::String ^ userName, bool createPersistentCookie);
public static void SetAuthCookie(string userName, bool createPersistentCookie);
static member SetAuthCookie : string * bool -> unit
Public Shared Sub SetAuthCookie (userName As String, createPersistentCookie As Boolean)

參數

userName
String

一個已認證的使用者名稱。 這不一定要對應到 Windows 帳號。

createPersistentCookie
Boolean

true建立持久性 Cookie（跨瀏覽器會話儲存的 Cookie）;否則，。 false

例外狀況

HttpException

RequireSSL是true且 IsSecureConnection 。false

備註

此 SetAuthCookie 方法會將表單認證工單加入 cookies 集合，或若 CookiesSupported 為 時 false則加到 URL 中。 表單認證單會提供表單認證資訊給瀏覽器下一次的請求。 透過表單認證，你可以在想要驗證使用者同時保留導覽控制權時使用 SetAuthCookie 這個方法。

另請參閱

適用於

SetAuthCookie(String, Boolean, String)

為所提供的使用者名稱建立認證工單，並將其加入回應的 cookie 集合中，使用提供的 cookie 路徑，或若使用無 cookie 認證則使用 URL。

public:
 static void SetAuthCookie(System::String ^ userName, bool createPersistentCookie, System::String ^ strCookiePath);
public static void SetAuthCookie(string userName, bool createPersistentCookie, string strCookiePath);
static member SetAuthCookie : string * bool * string -> unit
Public Shared Sub SetAuthCookie (userName As String, createPersistentCookie As Boolean, strCookiePath As String)

參數

userName
String

一個已認證的使用者名稱。

createPersistentCookie
Boolean

true建立一個持久的 Cookie（跨瀏覽器會話儲存的 Cookie）;否則，。 false

strCookiePath
String

表單驗證單的 cookie 路徑。

例外狀況

HttpException

RequireSSL是true且 IsSecureConnection 。false

備註

此SetAuthCookie方法會在 cookies 集合或 若為 時false的 URL CookiesSupported 中加入表單驗證票。 表單認證單會提供表單認證資訊給瀏覽器下一次的請求。 透過表單認證，你可以在想要驗證使用者同時保留導覽控制權時使用 SetAuthCookie 這個方法。

另請參閱

適用於