Login.Authenticate Événement

Référence

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.dll

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

AuthenticateEventHandler

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 .

S’applique à