FormsAuthentication.SetAuthCookie 方法

定义

命名空间:
System.Web.Security
程序集:
System.Web.dll

为提供的用户名创建身份验证票证，并将其添加到响应的 Cookie 集合中;如果使用无 Cookie 身份验证，请将其添加到 URL。

重载

名称 说明
SetAuthCookie(String, Boolean)

为提供的用户名创建身份验证票证，并将其添加到响应的 Cookie 集合中;如果使用无 Cookie 身份验证，请将其添加到 URL。
SetAuthCookie(String, Boolean, String)

为提供的用户名创建身份验证票证，并在使用提供的 Cookie 路径或使用 URL（如果使用无 Cookie 身份验证）将其添加到响应的 Cookie 集合中。

注解

此方法 SetAuthCookie 将表单身份验证票证添加到 Cookie 集合或 URL（如果 CookiesSupported 为 false）。 表单身份验证票证向浏览器发出的下一个请求提供表单身份验证信息。 使用表单身份验证时，可以在想要对用户进行身份验证时使用 SetAuthCookie 该方法，但仍使用重定向来保留对导航的控制。

SetAuthCookie(String, Boolean)

为提供的用户名创建身份验证票证，并将其添加到响应的 Cookie 集合中;如果使用无 Cookie 身份验证，请将其添加到 URL。

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 is true and IsSecureConnection is false.

注解

该方法 SetAuthCookie 将表单身份验证票证添加到 Cookie 集合，或者添加到 URL（如果 CookiesSupported 为 false）。 表单身份验证票证向浏览器发出的下一个请求提供表单身份验证信息。 使用表单身份验证时，可以在想要对用户进行身份验证时使用 SetAuthCookie 该方法，但仍使用重定向来保留对导航的控制。

另请参阅

适用于

SetAuthCookie(String, Boolean, String)

为提供的用户名创建身份验证票证，并在使用提供的 Cookie 路径或使用 URL（如果使用无 Cookie 身份验证）将其添加到响应的 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 is true and IsSecureConnection is false.

注解

此方法 SetAuthCookie 将表单身份验证票证添加到 Cookie 集合或 URL（如果 CookiesSupported 为 false）。 表单身份验证票证向浏览器发出的下一个请求提供表单身份验证信息。 使用表单身份验证时，可以在想要对用户进行身份验证时使用 SetAuthCookie 该方法，但仍使用重定向来保留对导航的控制。

另请参阅

适用于