Login.Authenticate Login.Authenticate Login.Authenticate Login.Authenticate Event

Definizione

Si verifica quando un utente viene autenticato.Occurs when a user is authenticated.

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 

Esempi

Nell'esempio di codice seguente viene Authenticate usato l'evento per chiamare il codice di autenticazione personalizzato specifico del sito.The following code example uses the Authenticate event to call site-specific custom authentication code.

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

Commenti

L' Authenticate evento viene generato quando un utente utilizza il Login controllo per accedere a un sito Web.The Authenticate event is raised when a user uses the Login control to log in to a Web site. Gli schemi di autenticazione personalizzati possono Authenticate usare l'evento per autenticare gli utenti.Custom authentication schemes can use the Authenticate event to authenticate users.

Nota

Quando un utente utilizza il Login controllo per accedere a un sito Web, tutti i dati nello stato di visualizzazione e tutti i dati post vengono persi.When a user uses the Login control to log in to a Web site, all data in the view state and all post data is lost. Non eseguire azioni nell' Authenticate evento che si basa sullo stato di visualizzazione.Do not perform actions in the Authenticate event that rely on the view state.

Per ulteriori informazioni sulla gestione degli eventi, consultare gestione e generazione di eventi.For more information about handling events, see Handling and Raising Events.

Note per gli eredi

Gli schemi di autenticazione personalizzati devono Authenticated impostare la true proprietà su per indicare che un utente è stato autenticato.Custom authentication schemes should set the Authenticated property to true to indicate that a user has been authenticated.

Quando un utente invia le proprie informazioni di accesso, Login il controllo genera prima l' LoggingIn evento, quindi l' Authenticate evento e infine l' LoggedIn evento.When a user submits his or her login information, the Login control first raises the LoggingIn event, then the Authenticate event, and finally the LoggedIn event.

Si applica a

Vedi anche