Login.Authenticate Ereignis

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Tritt beim Authentifizieren eines Benutzers ein.

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

Ereignistyp

AuthenticateEventHandler

Beispiele

Im folgenden Codebeispiel wird das Authenticate -Ereignis verwendet, um standortspezifischen benutzerdefinierten Authentifizierungscode aufzurufen.

<%@ 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 das Login Steuerelement verwendet, um sich bei einer Website anzumelden. Benutzerdefinierte Authentifizierungsschemas können das Authenticate -Ereignis verwenden, um Benutzer zu authentifizieren.

Hinweis

Wenn ein Benutzer das Login -Steuerelement verwendet, um sich bei einer Website anzumelden, gehen alle Daten im Ansichtszustand und alle Postdaten verloren. Führen Sie keine Aktionen in dem Authenticate Ereignis aus, das auf dem Ansichtszustand basiert.

Weitere Informationen zur Behandlung von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.

Hinweise für Vererber

Benutzerdefinierte Authentifizierungsschemas sollten die Authenticated -Eigenschaft auf true festlegen, um anzugeben, dass ein Benutzer authentifiziert wurde.

Wenn ein Benutzer seine Anmeldeinformationen übermittelt, löst das Login Steuerelement zuerst das LoggingIn -Ereignis, dann das Authenticate -Ereignis und schließlich das -Ereignis aus LoggedIn .

Gilt für:

Weitere Informationen