Login.Authenticate Evento

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Si verifica quando un utente viene autenticato.

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

Tipo evento

AuthenticateEventHandler

Esempio

Nell'esempio di codice seguente viene usato l'evento per chiamare codice Authenticate di autenticazione personalizzato specifico del sito.

<%@ 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'evento Authenticate viene generato quando un utente usa il Login controllo per accedere a un sito Web. Gli schemi di autenticazione personalizzati possono usare l'evento Authenticate per autenticare gli utenti.

Nota

Quando un utente usa il Login controllo per accedere a un sito Web, tutti i dati nello stato di visualizzazione e tutti i dati post vengono persi. Non eseguire azioni nell'evento Authenticate che si basano sullo stato di visualizzazione.

Per ulteriori informazioni sulla gestione degli eventi, consultare gestione e generazione di eventi.

Note per gli eredi

Gli schemi di autenticazione personalizzati devono impostare la Authenticated proprietà su true per indicare che un utente è stato autenticato.

Quando un utente invia le informazioni di accesso, il Login controllo genera prima l'evento LoggingIn , quindi l'evento Authenticate e infine l'evento LoggedIn .

Si applica a