Partager via

AuthenticateEventArgs.Authenticated Propriété

Définition

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

Obtient ou définit une valeur indiquant si la tentative d’authentification d’un utilisateur a réussi.

public:
 property bool Authenticated { bool get(); void set(bool value); };
public bool Authenticated { get; set; }
member this.Authenticated : bool with get, set
Public Property Authenticated As Boolean

Valeur de propriété

Boolean

true si la tentative d’authentification a réussi ; sinon, false.

Exemples

L’exemple de code suivant utilise la Authenticated propriété avec un schéma d’authentification personnalisé pour indiquer la réussite ou l’échec de la tentative de connexion d’un utilisateur.

<%@ 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

Utilisez la Authenticated propriété dans les schémas d’authentification personnalisés implémentés dans le Login.Authenticate gestionnaire d’événements pour indiquer la réussite ou l’échec de la tentative de connexion de l’utilisateur.

Définir la Authenticated propriété pour false indiquer que l’utilisateur du site Web n’a pas présenté d’informations d’identification valides et que le Login contrôle doit déclencher l’événement LoginError en plus d’afficher du texte indiquant que la tentative de connexion n’a pas réussi. L’événement LoginError permet au développeur de pages de disposer de processus ou d’actions supplémentaires lorsque l’authentification de l’utilisateur n’est pas réussie. Paramètre Authenticated indiquant true que l’utilisateur a présenté des informations d’identification valides et que le Login contrôle doit déclencher l’événement LoggedIn et rediriger l’utilisateur vers la page active ou vers la page indiquée par DestinationPageUrl.

S’applique à

Voir aussi