FormsAuthentication.SetAuthCookie 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
为提供的用户名创建一个身份验证票证,并将该票证添加到响应的 Cookie 集合中或 URL 中(如果使用的是无 Cookie 身份验证)。
重载
SetAuthCookie(String, Boolean) |
为提供的用户名创建一个身份验证票证,并将该票证添加到响应的 Cookie 集合中或 URL 中(如果使用的是无 Cookie 身份验证)。 |
SetAuthCookie(String, Boolean, String) |
为提供的用户名创建一个身份验证票证,并使用提供的 cookie 路径或使用 URL(如果使用的是无 Cookie 身份验证)将该票证添加到响应的 Cookie 集合中。 |
注解
如果 CookiesSupportedfalse
为 ,则 SetAuthCookie 方法将表单身份验证票证添加到 Cookie 集合或 URL。 forms-authentication 票证向浏览器发出的下一个请求提供 forms-authentication 信息。 使用表单身份验证时,当想要对用户进行身份验证但仍保留对重定向导航的控制时,可以使用 SetAuthCookie 方法。
SetAuthCookie(String, Boolean)
为提供的用户名创建一个身份验证票证,并将该票证添加到响应的 Cookie 集合中或 URL 中(如果使用的是无 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
。
例外
RequireSSL 为 true
,而 IsSecureConnection 为 false
。
注解
方法 SetAuthCookie 将表单身份验证票证添加到 Cookies 集合或 URL(如果 CookiesSupported 为 false
)。 forms-authentication 票证向浏览器发出的下一个请求提供 forms-authentication 信息。 使用表单身份验证时,当想要对用户进行身份验证但仍保留对重定向导航的控制时,可以使用 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
若要创建持久 Cookie(跨浏览器会话保存的 Cookie),则为 true
;否则为 false
。
- strCookiePath
- String
Forms 身份验证票证的 Cookie 路径。
例外
RequireSSL 为 true
,而 IsSecureConnection 为 false
。
注解
如果 CookiesSupportedfalse
为 ,则 SetAuthCookie 方法将表单身份验证票证添加到 Cookie 集合或 URL。 forms-authentication 票证向浏览器发出的下一个请求提供 forms-authentication 信息。 使用表单身份验证时,当想要对用户进行身份验证但仍保留对重定向导航的控制时,可以使用 SetAuthCookie 方法。