FormsAuthentication.SetAuthCookie 方法

  • 參考

定義

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

為所提供的使用者名稱建立驗證票證，並將該票證加入至回應的 Cookie 集合，或加入至 URL (若使用的是 Cookieless 驗證)。

多載

SetAuthCookie(String, Boolean)

為所提供的使用者名稱建立驗證票證，並將該票證加入至回應的 Cookie 集合，或加入至 URL (若使用的是 Cookieless 驗證)。
SetAuthCookie(String, Boolean, String)

為所提供的使用者名稱建立驗證票證，並使用提供的 Cookie 路徑或使用 URL (若是使用 Cookieless 驗證)，將該票證加入至回應的 Cookie 集合。

備註

如果 是 ，此方法 SetAuthCookie 會將表單驗證票證新增至 Cookie 集合或 URL CookiesSupported 。 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。

例外狀況

HttpException

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 路徑。

例外狀況

HttpException

RequireSSL 是 true，而 IsSecureConnection 是 false。

備註

如果 是 ，此方法 SetAuthCookie 會將表單驗證票證新增至 Cookie 集合或 URL CookiesSupported 。 false 表單驗證票證會將表單驗證資訊提供給瀏覽器提出的下一個要求。 使用表單驗證時，您可以在想要驗證使用者時使用 SetAuthCookie 方法，但仍會保留使用重新導向的流覽控制權。

另請參閱

適用於