FormsAuthentication.RedirectFromLoginPage Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Omdirigerar en autentiserad användare tillbaka till den ursprungligen begärda URL:en eller standard-URL:en.
Överlagringar
| Name | Description |
|---|---|
| RedirectFromLoginPage(String, Boolean) |
Omdirigerar en autentiserad användare tillbaka till den ursprungligen begärda URL:en eller standard-URL:en. |
| RedirectFromLoginPage(String, Boolean, String) |
Omdirigerar en autentiserad användare tillbaka till den ursprungligen begärda URL:en eller standard-URL:en med den angivna cookiesökvägen för cookien för formulärautentisering. |
RedirectFromLoginPage(String, Boolean)
Omdirigerar en autentiserad användare tillbaka till den ursprungligen begärda URL:en eller standard-URL:en.
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)
Parametrar
- userName
- String
Det autentiserade användarnamnet.
- createPersistentCookie
- Boolean
trueför att skapa en varaktig cookie (en som sparas i webbläsarsessioner); annars . false
Undantag
Retur-URL:en som anges i frågesträngen innehåller ett annat protokoll än HTTP: eller HTTPS:.
Exempel
I följande kodexempel omdirigeras verifierade användare till antingen den ursprungligen begärda URL:en eller DefaultUrl. Kodexemplet använder ASP.NET medlemskap för att verifiera användare. Mer information om ASP.NET medlemskap finns i Hantera användare med hjälp av medlemskap.
Important
Det här exemplet innehåller en textruta som accepterar användarindata, vilket är ett potentiellt säkerhetshot. Som standard kontrollerar ASP.NET webbsidor att användarindata inte innehåller skript- eller HTML-element. Mer information finns i Översikt över skriptexploateringar.
<%@ Page Language="C#" %>
<%@ Import Namespace="System.Web.Security" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
public void Login_OnClick(object sender, EventArgs args)
{
if (Membership.ValidateUser(UsernameTextbox.Text, PasswordTextbox.Text))
FormsAuthentication.RedirectFromLoginPage(UsernameTextbox.Text, NotPublicCheckBox.Checked);
else
Msg.Text = "Login failed. Please check your user name and password and try again.";
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Login</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Login</h3>
<asp:Label id="Msg" ForeColor="maroon" runat="server" /><br />
Username: <asp:Textbox id="UsernameTextbox" runat="server" /><br />
Password: <asp:Textbox id="PasswordTextbox" runat="server" TextMode="Password" /><br />
<asp:Button id="LoginButton" Text="Login" OnClick="Login_OnClick" runat="server" />
<asp:CheckBox id="NotPublicCheckBox" runat="server" />
Check here if this is <span style="text-decoration:underline">not</span> a public computer.
</form>
</body>
</html>
<%@ Page Language="VB" %>
<%@ Import Namespace="System.Web.Security" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Public Sub Login_OnClick(sender As Object, args As EventArgs)
If (Membership.ValidateUser(UsernameTextbox.Text, PasswordTextbox.Text)) Then
FormsAuthentication.RedirectFromLoginPage(UsernameTextbox.Text, NotPublicCheckBox.Checked)
Else
Msg.Text = "Login failed. Please check your user name and password and try again."
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Login</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Login</h3>
<asp:Label id="Msg" ForeColor="maroon" runat="server" /><br />
Username: <asp:Textbox id="UsernameTextbox" runat="server" /><br />
Password: <asp:Textbox id="PasswordTextbox" runat="server" TextMode="Password" /><br />
<asp:Button id="LoginButton" Text="Login" OnClick="Login_OnClick" runat="server" />
<asp:CheckBox id="NotPublicCheckBox" runat="server" />
Check here if this is <span style="text-decoration:underline">not</span> a public computer.
</form>
</body>
</html>
Kommentarer
Metoden RedirectFromLoginPage omdirigerar till den URL som anges i frågesträngen med variabelnamnet ReturnURL . I URL:en http://www.contoso.com/login.aspx?ReturnUrl=caller.aspxRedirectFromLoginPage omdirigeras metoden till exempel till retur-URL:en caller.aspx. Om variabeln ReturnURL inte finns RedirectFromLoginPage omdirigeras metoden till URL:en i DefaultUrl egenskapen.
ASP.NET lägger automatiskt till retur-URL:en när webbläsaren omdirigeras till inloggningssidan.
Som standard måste variabeln ReturnUrl referera till en sida i det aktuella programmet. Om ReturnUrl refererar till en sida i ett annat program eller på en annan server RedirectFromLoginPage omdirigeras metoderna till URL:en i DefaultUrl egenskapen. Om du vill tillåta omdirigeringar till en sida utanför det aktuella programmet måste du ange EnableCrossAppRedirects egenskapen till true med hjälp enableCrossAppRedirects av attributet för formulärkonfigurationselementet.
Important
Att ställa in egenskapen EnableCrossAppRedirects på true för att tillåta omdirigeringar mellan program är ett potentiellt säkerhetshot. För mer information, se egenskapen EnableCrossAppRedirects.
Om egenskapen CookiesSupported är true, och antingen variabeln ReturnUrl finns i det aktuella programmet eller EnableCrossAppRedirects egenskapen är true, RedirectFromLoginPage utfärdar metoden en autentiseringsbiljett och placerar den i standardcookien SetAuthCookie med hjälp av metoden.
Om CookiesSupported är false och omdirigeringssökvägen är till en URL i det aktuella programmet utfärdas biljetten som en del av omdirigerings-URL:en. Om CookiesSupported är false, EnableCrossAppRedirects är trueoch omdirigerings-URL:en inte refererar till en sida i det aktuella programmet, RedirectFromLoginPage utfärdar metoden en autentiseringsbiljett och placerar den i QueryString egenskapen.
Se även
Gäller för
RedirectFromLoginPage(String, Boolean, String)
Omdirigerar en autentiserad användare tillbaka till den ursprungligen begärda URL:en eller standard-URL:en med den angivna cookiesökvägen för cookien för formulärautentisering.
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)
Parametrar
- userName
- String
Det autentiserade användarnamnet.
- createPersistentCookie
- Boolean
trueför att skapa en varaktig cookie (en som sparas i webbläsarsessioner); annars . false
- strCookiePath
- String
Cookiesökvägen för formulärautentiseringsbiljetten.
Undantag
Retur-URL:en som anges i frågesträngen innehåller ett annat protokoll än HTTP: eller HTTPS:.
Kommentarer
Metoden RedirectFromLoginPage omdirigerar till den retur-URL som anges i frågesträngen ReturnURL med variabelnamnet. I URL:en http://www.contoso.com/login.aspx?ReturnUrl=caller.aspxRedirectFromLoginPage omdirigeras metoden till exempel till retur-URL:en caller.aspx. Om variabeln ReturnURL inte finns RedirectFromLoginPage omdirigeras metoden till URL:en i DefaultUrl egenskapen.
ASP.NET lägger automatiskt till retur-URL:en när webbläsaren omdirigeras till inloggningssidan.
Som standard måste variabeln ReturnUrl referera till en sida i det aktuella programmet. Om ReturnUrl refererar till en sida i ett annat program eller på en annan server RedirectFromLoginPage omdirigeras metoden till URL:en i DefaultUrl egenskapen. Om du vill tillåta omdirigeringar till en sida utanför det aktuella programmet måste du ange EnableCrossAppRedirects egenskapen till true med hjälp enableCrossAppRedirects av attributet för formulärkonfigurationselementet.
Important
Att ställa in egenskapen EnableCrossAppRedirects på true för att tillåta omdirigeringar mellan program är ett potentiellt säkerhetshot. För mer information, se egenskapen EnableCrossAppRedirects.
CookiesSupported Om egenskapen är true, och antingen variabeln ReturnUrl finns i det aktuella programmet eller EnableCrossAppRedirects egenskapen är true, RedirectFromLoginPage utfärdar metoden en autentiseringsbiljett och placerar den i den cookie som anges av parametern strCookiePath med hjälp av SetAuthCookie metoden.
Om CookiesSupported är false och omdirigeringssökvägen är till en URL i det aktuella programmet utfärdas biljetten som en del av omdirigerings-URL:en. Om CookiesSupported är false, EnableCrossAppRedirects är trueoch omdirigerings-URL:en inte refererar till en sida i det aktuella programmet, RedirectFromLoginPage utfärdar metoden en autentiseringsbiljett och placerar den i QueryString egenskapen.