Login.Authenticate Ereignis
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Tritt auf, wenn ein Benutzer authentifiziert wird.
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 Ereignistyp
Beispiele
Im folgenden Codebeispiel wird das Authenticate Ereignis verwendet, um standortspezifischen benutzerdefinierten Authentifizierungscode aufzurufen.
<%@ 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>
Hinweise
Das Authenticate Ereignis wird ausgelöst, wenn ein Benutzer das Login Steuerelement verwendet, um sich bei einer Website anzumelden. Benutzerdefinierte Authentifizierungsschemas können das Authenticate Ereignis verwenden, um Benutzer zu authentifizieren.
Note
Wenn ein Benutzer das Login Steuerelement zum Anmelden bei einer Website verwendet, gehen alle Daten im Ansichtszustand und alle Postdaten verloren. Führen Sie keine Aktionen für das Authenticate Ereignis aus, das auf den Ansichtszustand angewiesen ist.
Weitere Informationen zur Behandlung von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.
Hinweise für Vererber
Benutzerdefinierte Authentifizierungsschemas sollten die Authenticated Eigenschaft true so festlegen, dass ein Benutzer authentifiziert wurde.
Wenn ein Benutzer seine Anmeldeinformationen übermittelt, löst das Login Steuerelement zuerst das LoggingIn Ereignis, dann das Authenticate Ereignis und schließlich das LoggedIn Ereignis aus.
