FormsAuthentication.SetAuthCookie 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
為所提供的使用者名稱建立驗證票證,並將該票證加入至回應的 Cookie 集合,或加入至 URL (若使用的是 Cookieless 驗證)。
多載
SetAuthCookie(String, Boolean) |
為所提供的使用者名稱建立驗證票證,並將該票證加入至回應的 Cookie 集合,或加入至 URL (若使用的是 Cookieless 驗證)。 |
SetAuthCookie(String, Boolean, String) |
為所提供的使用者名稱建立驗證票證,並使用提供的 Cookie 路徑或使用 URL (若是使用 Cookieless 驗證),將該票證加入至回應的 Cookie 集合。 |
備註
如果 是 ,此方法SetAuthCookie會將窗體驗證票證新增至 Cookie 集合或 URLCookiesSupported。false
窗體驗證票證會將窗體驗證資訊提供給瀏覽器提出的下一個要求。 使用窗體驗證時,您可以在想要驗證使用者時使用 SetAuthCookie 方法,但仍使用重新導向來保留流覽的控制。
SetAuthCookie(String, Boolean)
為所提供的使用者名稱建立驗證票證,並將該票證加入至回應的 Cookie 集合,或加入至 URL (若使用的是 Cookieless 驗證)。
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
。
例外狀況
RequireSSL 是 true
,而 IsSecureConnection 是 false
。
備註
方法會將 SetAuthCookie 窗體驗證票證新增至 Cookies 集合,如果 CookiesSupported 為 false
,則新增至 URL。 窗體驗證票證會將窗體驗證資訊提供給瀏覽器提出的下一個要求。 使用窗體驗證時,您可以在想要驗證使用者時使用 SetAuthCookie 方法,但仍使用重新導向來保留流覽的控制。
另請參閱
適用於
SetAuthCookie(String, Boolean, String)
為所提供的使用者名稱建立驗證票證,並使用提供的 Cookie 路徑或使用 URL (若是使用 Cookieless 驗證),將該票證加入至回應的 Cookie 集合。
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 路徑。
例外狀況
RequireSSL 是 true
,而 IsSecureConnection 是 false
。
備註
如果 是 ,此方法SetAuthCookie會將窗體驗證票證新增至 Cookie 集合或 URLCookiesSupported。false
窗體驗證票證會將窗體驗證資訊提供給瀏覽器提出的下一個要求。 使用窗體驗證時,您可以在想要驗證使用者時使用 SetAuthCookie 方法,但仍使用重新導向來保留流覽的控制。