AuthenticateEventArgs.Authenticated Propriété

  • Référence

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 propriété dans les Authenticated 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.

La définition de la Authenticated propriété sur false indique 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 le texte indiquant que la tentative de connexion n’a pas réussi. L’événement LoginError permet au développeur de pages d’avoir des processus ou des actions supplémentaires en cas d’échec de l’authentification de l’utilisateur. La définition de sur true indique 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.Authenticated

S’applique à

Voir aussi