Login.Authenticate Événement
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Se produit lorsqu'un utilisateur est authentifié.
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 Type d'événement
Exemples
L’exemple de code suivant utilise l’événement pour appeler un Authenticate code d’authentification personnalisé spécifique au site.
<%@ 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>
Remarques
L’événement Authenticate est déclenché lorsqu’un utilisateur utilise le Login contrôle pour se connecter à un site Web. Les schémas d’authentification personnalisés peuvent utiliser l’événement Authenticate pour authentifier les utilisateurs.
Notes
Lorsqu’un utilisateur utilise le Login contrôle pour se connecter à un site web, toutes les données dans l’état d’affichage et toutes les données post sont perdues. N’effectuez pas d’actions dans l’événement Authenticate qui repose sur l’état d’affichage.
Pour plus d'informations sur la gestion des événements, voir gestion et déclenchement d’événements.
Notes pour les héritiers
Les schémas d’authentification personnalisés doivent définir la Authenticated propriété sur true pour indiquer qu’un utilisateur a été authentifié.
Lorsqu’un utilisateur envoie ses informations de connexion, le Login contrôle déclenche d’abord l’événement LoggingIn , puis l’événement Authenticate et enfin l’événement LoggedIn .
