Login.Authenticate Ereignis

Definition

Tritt beim Authentifizieren eines Benutzers ein.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 

Beispiele

Im folgenden Codebeispiel wird das Authenticate -Ereignis verwendet, um Website spezifischen, benutzerdefinierten Authentifizierungscode aufzurufen.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>

Hinweise

Das Authenticate -Ereignis wird ausgelöst, wenn ein Benutzer Login das-Steuerelement verwendet, um sich bei einer Website anzumelden.The Authenticate event is raised when a user uses the Login control to log in to a Web site. Benutzerdefinierte Authentifizierungs Schemas können Authenticate das Ereignis verwenden, um Benutzer zu authentifizieren.Custom authentication schemes can use the Authenticate event to authenticate users.

Hinweis

Wenn ein Benutzer das Login -Steuerelement verwendet, um sich bei einer Website anzumelden, gehen alle Daten im Ansichts Zustand und alle Post-Daten verloren.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. Führen Sie keine Aktionen im Authenticate Ereignis aus, die auf dem Ansichts Zustand beruhen.Do not perform actions in the Authenticate event that rely on the view state.

Weitere Informationen zur Behandlung von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.For more information about handling events, see Handling and Raising Events.

Hinweise für Vererber

Benutzerdefinierte Authentifizierungs Schemas sollten Authenticated die- true Eigenschaft auf festlegen, um anzugeben, dass ein Benutzer authentifiziert wurde.Custom authentication schemes should set the Authenticated property to true to indicate that a user has been authenticated.

Wenn ein Benutzer seine Anmelde Informationen übermittelt, löst das Login Steuerelement zuerst das LoggingIn Ereignis, dann das Authenticate Ereignis und schließlich das LoggedIn Ereignis aus.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.

Gilt für:

Siehe auch