AuthenticateEventArgs.Authenticated Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan atau menetapkan nilai yang menunjukkan apakah upaya autentikasi pengguna berhasil.
public:
property bool Authenticated { bool get(); void set(bool value); };
public bool Authenticated { get; set; }
member this.Authenticated : bool with get, set
Public Property Authenticated As Boolean
Nilai Properti
true
jika upaya autentikasi berhasil; jika tidak, false
.
Contoh
Contoh kode berikut menggunakan Authenticated properti dengan skema autentikasi kustom untuk menunjukkan keberhasilan atau kegagalan upaya masuk pengguna.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
private bool SiteSpecificAuthenticationMethod(string UserName, string Password)
{
// Insert code that implements a site-specific custom
// authentication method here.
//
// This example implementation always returns false.
return false;
}
private void OnAuthenticate(object sender, AuthenticateEventArgs e)
{
bool Authenticated = false;
Authenticated = SiteSpecificAuthenticationMethod(Login1.UserName, Login1.Password);
e.Authenticated = Authenticated;
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:Login id="Login1" runat="server"
OnAuthenticate="OnAuthenticate">
</asp:Login>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Function SiteSpecificAuthenticationMethod(ByVal UserName As String, ByVal Password As String) As Boolean
' Insert code that implements a site-specific custom
' authentication method here.
'
' This example implementation always returns false.
Return False
End Function
Sub OnAuthenticate(ByVal sender As Object, ByVal e As AuthenticateEventArgs)
Dim Authenticated As Boolean
Authenticated = SiteSpecificAuthenticationMethod(Login1.UserName, Login1.Password)
e.Authenticated = Authenticated
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:Login id="Login1" runat="server"
OnAuthenticate="OnAuthenticate">
</asp:Login>
</form>
</body>
</html>
Keterangan
Authenticated Gunakan properti dalam skema autentikasi kustom yang diterapkan di Login.Authenticate penanganan aktivitas untuk menunjukkan keberhasilan atau kegagalan upaya masuk pengguna.
Mengatur properti ke Authenticatedfalse
menunjukkan bahwa pengguna situs Web belum menyajikan kredensial yang valid dan Login kontrol harus menaikkan LoginError peristiwa selain menampilkan teks yang menunjukkan bahwa upaya masuk tidak berhasil. Kejadian ini LoginError memungkinkan pengembang halaman untuk memiliki proses atau tindakan tambahan yang terjadi saat autentikasi pengguna tidak berhasil. Pengaturan Authenticated ke true
menunjukkan bahwa pengguna telah menyajikan kredensial yang valid dan Login kontrol harus menaikkan LoggedIn peristiwa dan mengalihkan pengguna kembali ke halaman saat ini atau ke halaman yang ditunjukkan oleh DestinationPageUrl.