Bagikan melalui

FormsAuthentication.RedirectFromLoginPage Metode

  • Referensi

Definisi

Ruang nama:
System.Web.Security
Rakitan:
System.Web.dll

Mengalihkan pengguna yang diautentikasi kembali ke URL yang awalnya diminta atau URL default.

Overload

RedirectFromLoginPage(String, Boolean)

Mengalihkan pengguna yang diautentikasi kembali ke URL yang awalnya diminta atau URL default.
RedirectFromLoginPage(String, Boolean, String)

Mengalihkan pengguna terautentikasi kembali ke URL yang awalnya diminta atau URL default menggunakan jalur cookie yang ditentukan untuk cookie autentikasi formulir.

RedirectFromLoginPage(String, Boolean)

Mengalihkan pengguna yang diautentikasi kembali ke URL yang awalnya diminta atau URL default.

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)

Parameter

userName
String

Nama pengguna yang diautentikasi.

createPersistentCookie
Boolean

true untuk membuat cookie tahan lama (cookie yang disimpan di seluruh sesi browser); jika tidak, false.

Pengecualian

HttpException

URL pengembalian yang ditentukan dalam string kueri berisi protokol selain HTTP: atau HTTPS:.

Contoh

Contoh kode berikut mengalihkan pengguna yang divalidasi ke URL yang awalnya diminta atau DefaultUrl. Contoh kode menggunakan keanggotaan ASP.NET untuk memvalidasi pengguna. Untuk informasi selengkapnya tentang keanggotaan ASP.NET, lihat Mengelola Pengguna dengan Menggunakan Keanggotaan.

Penting

Contoh ini berisi kotak teks yang menerima input pengguna, yang merupakan potensi ancaman keamanan. Secara default, ASP.NET halaman Web memvalidasi bahwa input pengguna tidak menyertakan elemen skrip atau HTML. Untuk informasi selengkapnya, lihat Gambaran Umum Eksploitasi Skrip.

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

Keterangan

Metode RedirectFromLoginPage mengalihkan ke URL yang ditentukan dalam string kueri menggunakan ReturnURL nama variabel. Misalnya, di URL http://www.contoso.com/login.aspx?ReturnUrl=caller.aspx, RedirectFromLoginPage metode mengalihkan ke URL caller.aspxpengembalian . ReturnURL Jika variabel tidak ada, RedirectFromLoginPage metode mengalihkan ke URL di DefaultUrl properti .

ASP.NET secara otomatis menambahkan URL pengembalian saat browser dialihkan ke halaman masuk.

Secara default, ReturnUrl variabel harus merujuk ke halaman dalam aplikasi saat ini. Jika ReturnUrl merujuk ke halaman di aplikasi yang berbeda atau di server yang berbeda, RedirectFromLoginPage metode mengalihkan ke URL di DefaultUrl properti . Jika Anda ingin mengizinkan pengalihan ke halaman di luar aplikasi saat ini, Anda harus mengatur EnableCrossAppRedirects properti ke true menggunakan enableCrossAppRedirects atribut elemen konfigurasi formulir .

Penting

EnableCrossAppRedirects Mengatur properti ke true untuk memungkinkan pengalihan lintas aplikasi adalah potensi ancaman keamanan. Untuk informasi selengkapnya, lihat EnableCrossAppRedirects properti.

CookiesSupported Jika properti adalah true, dan ReturnUrl variabel berada dalam aplikasi saat ini atau EnableCrossAppRedirects properti adalah true, maka RedirectFromLoginPage metode mengeluarkan tiket autentikasi dan menempatkannya di cookie default menggunakan SetAuthCookie metode .

Jika CookiesSupported adalah false dan jalur pengalihan adalah ke URL di aplikasi saat ini, tiket dikeluarkan sebagai bagian dari URL pengalihan. Jika CookiesSupported adalah false, EnableCrossAppRedirects adalah true, dan URL pengalihan tidak merujuk ke halaman dalam aplikasi saat ini, metode mengeluarkan RedirectFromLoginPage tiket autentikasi dan menempatkannya di QueryString properti .

Lihat juga

Berlaku untuk

RedirectFromLoginPage(String, Boolean, String)

Mengalihkan pengguna terautentikasi kembali ke URL yang awalnya diminta atau URL default menggunakan jalur cookie yang ditentukan untuk cookie autentikasi formulir.

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)

Parameter

userName
String

Nama pengguna yang diautentikasi.

createPersistentCookie
Boolean

true untuk membuat cookie tahan lama (cookie yang disimpan di seluruh sesi browser); jika tidak, false.

strCookiePath
String

Jalur cookie untuk tiket autentikasi formulir.

Pengecualian

HttpException

URL pengembalian yang ditentukan dalam string kueri berisi protokol selain HTTP: atau HTTPS:.

Keterangan

Metode RedirectFromLoginPage mengalihkan ke URL pengembalian yang ditentukan dalam string kueri menggunakan ReturnURL nama variabel. Misalnya, di URL http://www.contoso.com/login.aspx?ReturnUrl=caller.aspx, RedirectFromLoginPage metode mengalihkan ke URL caller.aspxpengembalian . ReturnURL Jika variabel tidak ada, RedirectFromLoginPage metode mengalihkan ke URL di DefaultUrl properti .

ASP.NET secara otomatis menambahkan URL pengembalian saat browser dialihkan ke halaman masuk.

Secara default, ReturnUrl variabel harus merujuk ke halaman dalam aplikasi saat ini. Jika ReturnUrl merujuk ke halaman di aplikasi yang berbeda atau di server yang berbeda, RedirectFromLoginPage metode mengalihkan ke URL di DefaultUrl properti . Jika Anda ingin mengizinkan pengalihan ke halaman di luar aplikasi saat ini, Anda harus mengatur EnableCrossAppRedirects properti ke true menggunakan enableCrossAppRedirects atribut elemen konfigurasi formulir .

Penting

EnableCrossAppRedirects Mengatur properti ke true untuk memungkinkan pengalihan lintas aplikasi adalah potensi ancaman keamanan. Untuk informasi selengkapnya, lihat EnableCrossAppRedirects properti.

CookiesSupported Jika properti adalah true, dan ReturnUrl variabel berada dalam aplikasi saat ini atau EnableCrossAppRedirects properti adalah true, maka RedirectFromLoginPage metode mengeluarkan tiket autentikasi dan menempatkannya di cookie yang ditentukan oleh strCookiePath parameter menggunakan SetAuthCookie metode .

Jika CookiesSupported adalah false dan jalur pengalihan adalah ke URL di aplikasi saat ini, tiket dikeluarkan sebagai bagian dari URL pengalihan. Jika CookiesSupported adalah false, EnableCrossAppRedirects adalah true, dan URL pengalihan tidak merujuk ke halaman dalam aplikasi saat ini, metode mengeluarkan RedirectFromLoginPage tiket autentikasi dan menempatkannya di QueryString properti .

Lihat juga

Berlaku untuk