FormsAuthentication.RedirectFromLoginPage Metódus

Definíció

Névtér:
System.Web.Security
Szerelvény:
System.Web.dll

Átirányít egy hitelesített felhasználót az eredetileg kért URL-címre vagy az alapértelmezett URL-címre.

Túlterhelések

Name Description
RedirectFromLoginPage(String, Boolean)

Átirányít egy hitelesített felhasználót az eredetileg kért URL-címre vagy az alapértelmezett URL-címre.
RedirectFromLoginPage(String, Boolean, String)

Átirányítja a hitelesített felhasználót az eredetileg kért URL-címre vagy az alapértelmezett URL-címre az űrlap-hitelesítési cookie megadott elérési útján.

RedirectFromLoginPage(String, Boolean)

Átirányít egy hitelesített felhasználót az eredetileg kért URL-címre vagy az alapértelmezett URL-címre.

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)

Paraméterek

userName
String

A hitelesített felhasználónév.

createPersistentCookie
Boolean

truetartós cookie létrehozása (amelyet böngésző-munkamenetek során mentenek); egyéb esetben. false

Kivételek

HttpException

A lekérdezési sztringben megadott visszatérési URL-cím nem HTTP: vagy HTTPS:protokollt tartalmaz.

Példák

Az alábbi példakód átirányítja az ellenőrzött felhasználókat az eredetileg kért URL-címre vagy a DefaultUrl. A példakód ASP.NET tagsággal ellenőrzi a felhasználókat. További információ a ASP.NET tagságról: Felhasználók kezelése tagsággal.

Important

Ez a példa egy szövegdobozt tartalmaz, amely elfogadja a felhasználói bemenetet, ami potenciális biztonsági fenyegetés. Alapértelmezés szerint ASP.NET weblapok ellenőrzik, hogy a felhasználói bevitel nem tartalmaz-e szkript- vagy HTML-elemeket. További információ: Szkript kihasználása – áttekintés.

<%@ 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>

Megjegyzések

A RedirectFromLoginPage metódus a változó nevével ReturnURL átirányítja a lekérdezési sztringben megadott URL-címre. Az URL-címben http://www.contoso.com/login.aspx?ReturnUrl=caller.aspxpéldául a RedirectFromLoginPage metódus a visszatérési URL-címre caller.aspxirányítja át a metódust. Ha a ReturnURL változó nem létezik, a RedirectFromLoginPage metódus átirányítja a tulajdonság URL-címére DefaultUrl .

ASP.NET automatikusan hozzáadja a visszatérési URL-címet, amikor a böngésző átirányítja a bejelentkezési oldalra.

Alapértelmezés szerint a változónak ReturnUrl az aktuális alkalmazásban lévő lapra kell hivatkoznia. Ha ReturnUrl egy másik alkalmazás vagy egy másik kiszolgálón lévő lapra hivatkozik, a RedirectFromLoginPage metódusok átirányítják a tulajdonság URL-címére DefaultUrl . Ha engedélyezni szeretné az átirányításokat az aktuális alkalmazáson kívüli lapra, akkor a EnableCrossAppRedirects tulajdonságot úgy kell beállítania, hogy true az enableCrossAppRedirectsűrlapkonfigurációs elem attribútumát használja.

Important

EnableCrossAppRedirects A tulajdonság alkalmazásközi átirányítások engedélyezésére true való beállítása potenciális biztonsági fenyegetés. További információért lásd a EnableCrossAppRedirects tulajdonságot.

Ha a CookiesSupported tulajdonság az true, és vagy a ReturnUrl változó az aktuális alkalmazáson belül van, vagy a EnableCrossAppRedirects tulajdonság az true, akkor a RedirectFromLoginPage metódus hitelesítési jegyet ad ki, és az alapértelmezett cookie-ban helyezi el a SetAuthCookie metódus használatával.

Ha CookiesSupported igen, false és az átirányítási útvonal egy URL-címre mutat az aktuális alkalmazásban, a rendszer az átirányítási URL-cím részeként adja ki a jegyet. Ha CookiesSupported igen false, EnableCrossAppRedirects akkor trueaz átirányítási URL-cím nem hivatkozik az aktuális alkalmazás egyik lapjára, a RedirectFromLoginPage metódus hitelesítési jegyet ad ki, és a QueryString tulajdonságban helyezi el.

Lásd még

A következőre érvényes:

RedirectFromLoginPage(String, Boolean, String)

Átirányítja a hitelesített felhasználót az eredetileg kért URL-címre vagy az alapértelmezett URL-címre az űrlap-hitelesítési cookie megadott elérési útján.

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)

Paraméterek

userName
String

A hitelesített felhasználónév.

createPersistentCookie
Boolean

truetartós cookie létrehozása (amelyet böngésző-munkamenetek során mentenek); egyéb esetben. false

strCookiePath
String

Az űrlaphitelesítési jegy cookie-elérési útja.

Kivételek

HttpException

A lekérdezési sztringben megadott visszatérési URL-cím nem HTTP: vagy HTTPS:protokollt tartalmaz.

Megjegyzések

A RedirectFromLoginPage metódus a változónév használatával átirányítja a lekérdezési sztringben megadott visszatérési ReturnURL URL-címre. Az URL-címben http://www.contoso.com/login.aspx?ReturnUrl=caller.aspxpéldául a RedirectFromLoginPage metódus a visszatérési URL-címre caller.aspxirányítja át a metódust. Ha a ReturnURL változó nem létezik, a RedirectFromLoginPage metódus átirányítja a tulajdonság URL-címére DefaultUrl .

ASP.NET automatikusan hozzáadja a visszatérési URL-címet, amikor a böngésző átirányítja a bejelentkezési oldalra.

Alapértelmezés szerint a változónak ReturnUrl az aktuális alkalmazásban lévő lapra kell hivatkoznia. Ha ReturnUrl egy másik alkalmazás vagy egy másik kiszolgálón lévő lapra hivatkozik, a RedirectFromLoginPage metódus átirányítja a tulajdonság URL-címére DefaultUrl . Ha engedélyezni szeretné az átirányításokat az aktuális alkalmazáson kívüli lapra, akkor a EnableCrossAppRedirects tulajdonságot úgy kell beállítania, hogy true az enableCrossAppRedirectsűrlapkonfigurációs elem attribútumát használja.

Important

EnableCrossAppRedirects A tulajdonság alkalmazásközi átirányítások engedélyezésére true való beállítása potenciális biztonsági fenyegetés. További információért lásd a EnableCrossAppRedirects tulajdonságot.

Ha a CookiesSupported tulajdonság true, és vagy a ReturnUrl változó az aktuális alkalmazáson belül van, vagy a EnableCrossAppRedirects tulajdonság az true, akkor a RedirectFromLoginPage metódus hitelesítési jegyet ad ki, és a paraméter által strCookiePath megadott cookie-ban helyezi el a SetAuthCookie metódus használatával.

Ha CookiesSupported igen, false és az átirányítási útvonal egy URL-címre mutat az aktuális alkalmazásban, a rendszer az átirányítási URL-cím részeként adja ki a jegyet. Ha CookiesSupported igen false, EnableCrossAppRedirects akkor trueaz átirányítási URL-cím nem hivatkozik az aktuális alkalmazás egyik lapjára, a RedirectFromLoginPage metódus hitelesítési jegyet ad ki, és a QueryString tulajdonságban helyezi el.

Lásd még

A következőre érvényes: