MobileFormsAuthentication.RedirectFromLoginPage Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Redirects an authenticated user back to the originally requested URL. This API is obsolete. For information about how to develop ASP.NET mobile applications, see Mobile Apps & Sites with ASP.NET.
Overloads
RedirectFromLoginPage(String, Boolean) |
Redirects an authenticated user to the originally requested URL after logging in. This API is obsolete. For information about how to develop ASP.NET mobile applications, see Mobile Apps & Sites with ASP.NET. |
RedirectFromLoginPage(String, Boolean, String) |
Redirects an authenticated user to the originally requested URL after logging in. This API is obsolete. For information about how to develop ASP.NET mobile applications, see Mobile Apps & Sites with ASP.NET. |
RedirectFromLoginPage(String, Boolean)
Redirects an authenticated user to the originally requested URL after logging in. This API is obsolete. For information about how to develop ASP.NET mobile applications, see Mobile Apps & Sites with ASP.NET.
public:
static void RedirectFromLoginPage(System::String ^ userName, bool createPersistentCookie);
public static void RedirectFromLoginPage (string userName, bool createPersistentCookie);
static member RedirectFromLoginPage : string * bool -> unit
Public Shared Sub RedirectFromLoginPage (userName As String, createPersistentCookie As Boolean)
Parameters
- userName
- String
Name of the user for cookie authentication purposes. This does not need to map to an account name and is used by URL Authorization.
- createPersistentCookie
- Boolean
Specifies whether or not a durable cookie (one that is session based or outlasts the session) must be issued.
Examples
The following example uses the RedirectFromLoginPage method to send an authenticated user to the originally requested URL.
<%@ Page Language="C#"
Inherits="System.Web.UI.MobileControls.MobilePage" %>
<%@ Register TagPrefix="mobile"
Namespace="System.Web.UI.MobileControls"
Assembly="System.Web.Mobile" %>
<%@ Import Namespace="System.Web.Security" %>
<%@ Import Namespace="System.Web.Mobile" %>
<script runat="server">
private void Login_Click(Object sender, EventArgs e)
{
// Perform Authentication check here by using
// UserEmail.Value and UserPswd.Value.
if (Membership.ValidateUser(UserEmail.Text, UserPswd.Text))
{
// Set the authorization cookie
FormsAuthentication.SetAuthCookie(UserEmail.Text, false);
// Redirect from login page
MobileFormsAuthentication.RedirectFromLoginPage(UserEmail.Text, true);
}
else
{
// Notify the user
lblError.Text = "Login invalid. Please check your credentials";
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<body>
<mobile:form id="form1" runat="server">
<Mobile:Label runat="server">Enter username</Mobile:Label>
<Mobile:TextBox id="UserEmail" runat="Server"/>
<Mobile:Label runat="server">Enter password</Mobile:Label>
<Mobile:TextBox id="UserPswd" runat="Server"/>
<Mobile:Command ID="Command1" runat="Server" OnClick="Login_Click"
SoftkeyLabel="og">Go</Mobile:Command>
<Mobile:Label runat="server" id="lblError" />
</mobile:form>
</body>
</html>
<%@ Page Language="VB"
Inherits="System.Web.UI.MobileControls.MobilePage" %>
<%@ Register TagPrefix="mobile"
Namespace="System.Web.UI.MobileControls"
Assembly="System.Web.Mobile" %>
<%@ Import Namespace="System.Web.Security" %>
<%@ Import Namespace="System.Web.Mobile" %>
<script runat="server">
Private Sub Login_Click(ByVal sender As Object, ByVal e As EventArgs)
' Perform Authentication check here by using
' UserEmail.Value and UserPswd.Value.
If (Membership.ValidateUser(UserEmail.Text, UserPswd.Text)) Then
' Set the authorization cookie
FormsAuthentication.SetAuthCookie(UserEmail.Text, False)
' Redirect from login page
MobileFormsAuthentication.RedirectFromLoginPage(UserEmail.Text, True)
Else
' Notify the user
lblError.Text = "Login invalid. Please check your credentials"
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<body>
<mobile:form id="form1" runat="server">
<Mobile:Label ID="Label1" runat="server">Enter username</Mobile:Label>
<Mobile:TextBox id="UserEmail" runat="Server"/>
<Mobile:Label ID="Label2" runat="server">Enter password</Mobile:Label>
<Mobile:TextBox id="UserPswd" runat="Server"/>
<Mobile:Command ID="Command1" runat="Server" OnClick="Login_Click"
SoftkeyLabel="og">Go</Mobile:Command>
<Mobile:Label runat="server" id="lblError" />
</mobile:form>
</body>
</html>
Remarks
The methods create an encrypted string from the authentication cookie and append it to the redirecting URL of the originating request. A client-side redirect is then issued for that URL. This can be used to work around the limitations of certain mobile devices that either do not support cookies, or support cookies that are too small for storing authentication information in a secure manner.
See also
Applies to
RedirectFromLoginPage(String, Boolean, String)
Redirects an authenticated user to the originally requested URL after logging in. This API is obsolete. For information about how to develop ASP.NET mobile applications, see Mobile Apps & Sites with ASP.NET.
public:
static void RedirectFromLoginPage(System::String ^ userName, bool createPersistentCookie, System::String ^ strCookiePath);
public static void RedirectFromLoginPage (string userName, bool createPersistentCookie, string strCookiePath);
static member RedirectFromLoginPage : string * bool * string -> unit
Public Shared Sub RedirectFromLoginPage (userName As String, createPersistentCookie As Boolean, strCookiePath As String)
Parameters
- userName
- String
Name of the user for cookie authentication purposes. This does not need to map to an account name and is used by URL Authorization.
- createPersistentCookie
- Boolean
Specifies whether or not a durable cookie (one that is session based or outlasts the session) must be issued.
- strCookiePath
- String
Returns the configured cookie path used for the current application.
Examples
The following example demonstrates how to use the RedirectFromLoginPage method to send the authenticated user back to the URL that was originally requested.
<%@ Page Language="C#"
Inherits="System.Web.UI.MobileControls.MobilePage" %>
<%@ Register TagPrefix="mobile"
Namespace="System.Web.UI.MobileControls"
Assembly="System.Web.Mobile" %>
<%@ Import Namespace="System.Web.Security" %>
<%@ Import Namespace="System.Web.Mobile" %>
<script runat="server">
private void Login_Click(Object sender, EventArgs e)
{
// Perform Authentication check here by using
// UserEmail.Value and UserPswd.Value.
if (Membership.ValidateUser(UserEmail.Text, UserPswd.Text))
{
// Set the authorization cookie
FormsAuthentication.SetAuthCookie(UserEmail.Text, false);
// Redirect from login page
MobileFormsAuthentication.RedirectFromLoginPage(UserEmail.Text, true);
}
else
{
// Notify the user
lblError.Text = "Login invalid. Please check your credentials";
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<body>
<mobile:form id="form1" runat="server">
<Mobile:Label runat="server">Enter username</Mobile:Label>
<Mobile:TextBox id="UserEmail" runat="Server"/>
<Mobile:Label runat="server">Enter password</Mobile:Label>
<Mobile:TextBox id="UserPswd" runat="Server"/>
<Mobile:Command ID="Command1" runat="Server" OnClick="Login_Click"
SoftkeyLabel="og">Go</Mobile:Command>
<Mobile:Label runat="server" id="lblError" />
</mobile:form>
</body>
</html>
<%@ Page Language="VB"
Inherits="System.Web.UI.MobileControls.MobilePage" %>
<%@ Register TagPrefix="mobile"
Namespace="System.Web.UI.MobileControls"
Assembly="System.Web.Mobile" %>
<%@ Import Namespace="System.Web.Security" %>
<%@ Import Namespace="System.Web.Mobile" %>
<script runat="server">
Private Sub Login_Click(ByVal sender As Object, ByVal e As EventArgs)
' Perform Authentication check here by using
' UserEmail.Value and UserPswd.Value.
If (Membership.ValidateUser(UserEmail.Text, UserPswd.Text)) Then
' Set the authorization cookie
FormsAuthentication.SetAuthCookie(UserEmail.Text, False)
' Redirect from login page
MobileFormsAuthentication.RedirectFromLoginPage(UserEmail.Text, True)
Else
' Notify the user
lblError.Text = "Login invalid. Please check your credentials"
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<body>
<mobile:form id="form1" runat="server">
<Mobile:Label ID="Label1" runat="server">Enter username</Mobile:Label>
<Mobile:TextBox id="UserEmail" runat="Server"/>
<Mobile:Label ID="Label2" runat="server">Enter password</Mobile:Label>
<Mobile:TextBox id="UserPswd" runat="Server"/>
<Mobile:Command ID="Command1" runat="Server" OnClick="Login_Click"
SoftkeyLabel="og">Go</Mobile:Command>
<Mobile:Label runat="server" id="lblError" />
</mobile:form>
</body>
</html>
Remarks
The methods create an encrypted string from the authentication cookie and append it to the redirecting URL of the originating request. A client-side redirect is then issued for that URL. This can be used to work around the limitations of certain mobile devices that either do not support cookies, or support cookies that are too small for storing authentication information in a secure manner.