Cette documentation est archivée et n’est pas conservée.

Login.Authenticate, événement

Remarque : cet événement est nouveau dans le .NET Framework version 2.0.

Se produit lorsqu'un utilisateur est authentifié.

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)

public event AuthenticateEventHandler Authenticate
/** @event */
public void add_Authenticate (AuthenticateEventHandler value)

/** @event */
public void remove_Authenticate (AuthenticateEventHandler value)

JScript prend en charge l'utilisation d'événements mais pas la déclaration de nouveaux événements.

L'événement Authenticate est déclenché lorsqu'un utilisateur utilise le contrôle Login pour se connecter à un site Web. Les schémas d'authentification personnalisés peuvent utiliser l'événement Authenticate pour authentifier les utilisateurs.

RemarqueRemarque

Lorsqu'un utilisateur utilise le contrôle Login pour se connecter à un site Web, toutes les données dans l'état d'affichage et toutes les données de publication sont perdues. N'exécutez pas d'actions dans l'événement Authenticate qui reposent sur l'état d'affichage.

Pour plus d'informations sur la gestion des événements, consultez Gestion et déclenchement d'événements.

Remarques à l'attention des implémenteurs Les schémas d'authentification personnalisés doivent attribuer true à la propriété Authenticated pour indiquer qu'un utilisateur a été authentifié. Lorsqu'un utilisateur envoie ses informations de connexion, le contrôle Login déclenche en premier l'événement LoggingIn, puis l'événement Authenticate et enfin l'événement LoggedIn.

L'exemple de code suivant utilise l'événement Authenticate pour appeler le 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>
    <BODY>
        <FORM runat="server">
            <asp:Login id="Login1" runat="server"
                OnAuthenticate="OnAuthenticate">
            </asp:Login>
        </FORM>
    </BODY>
</HTML>

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0
Afficher: