Login.Authenticate Zdarzenie
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Występuje, gdy użytkownik jest uwierzytelniony.
public:
event System::Web::UI::WebControls::AuthenticateEventHandler ^ Authenticate;
public event System.Web.UI.WebControls.AuthenticateEventHandler Authenticate;
member this.Authenticate : System.Web.UI.WebControls.AuthenticateEventHandler
Public Custom Event Authenticate As AuthenticateEventHandler
Typ zdarzenia
Przykłady
Poniższy przykład kodu używa Authenticate zdarzenia do wywołania niestandardowego kodu uwierzytelniania specyficznego dla witryny.
<%@ 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>
Uwagi
Zdarzenie Authenticate jest zgłaszane, gdy użytkownik używa kontrolki Login do logowania się do witryny sieci Web. Niestandardowe schematy uwierzytelniania mogą używać zdarzenia Authenticate do uwierzytelniania użytkowników.
Uwaga
Gdy użytkownik używa kontrolki Login do logowania się do witryny sieci Web, wszystkie dane w stanie widoku i wszystkie dane po wpisach zostaną utracone. Nie wykonuj akcji w Authenticate przypadku, które polegają na stanie widoku.
Aby uzyskać więcej informacji na temat obsługi zdarzeń, zobacz Obsługa i podnoszenie zdarzeń.
Uwagi dotyczące dziedziczenia
Niestandardowe schematy uwierzytelniania powinny ustawić Authenticated właściwość na , true
aby wskazać, że użytkownik został uwierzytelniony.
Gdy użytkownik przesyła swoje informacje logowania, kontrolka Login najpierw zgłasza LoggingIn zdarzenie, Authenticate zdarzenie, a na koniec LoggedIn zdarzenie.