Login.OnLoginError(EventArgs) Methode

Definition

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

Löst das LoginError Ereignis aus, wenn ein Anmeldeversuch fehlschlägt.

protected:
 virtual void OnLoginError(EventArgs ^ e);
protected virtual void OnLoginError(EventArgs e);
abstract member OnLoginError : EventArgs -> unit
override this.OnLoginError : EventArgs -> unit
Protected Overridable Sub OnLoginError (e As EventArgs)

Parameter

e
EventArgs

Eine EventArgs , die die Ereignisdaten enthält.

Beispiele

Im folgenden Codebeispiel wird das LoginError Ereignis verwendet, um Hilfelinks für den Benutzer anzuzeigen, wenn ein Anmeldeversuch fehlschlägt.

<%@ 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">
// This custom Login control displays help
// information if the user does not log in
// on the first attempt.
class CustomLogin : Login
{
    override protected void OnLoginError(EventArgs e)
    {
        HelpPageText = "Help with logging in...";
        CreateUserText = "Create a new user...";
        PasswordRecoveryText = "Forgot your password?";
    }
    
    public CustomLogin() 
    {
        CreateUserUrl = "createUser.aspx";
        HelpPageUrl = "loginHelp.aspx";
        PasswordRecoveryUrl = "getPass.aspx";
    }
}
    // Add the custom login control to the page.
    void Page_Load(object sender, EventArgs e) 
    {
        CustomLogin loginControl = new CustomLogin();
        loginControl.ID = "loginControl";
        Placeholder1.Controls.Add(loginControl);
    }

</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:placeholder id="Placeholder1" runat="server"></asp:placeholder>
        </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">
    ' This custom Login control displays help
    ' informatin if the user does not log in
    ' on the first attempt.
    Class CustomLogin
        Inherits Login
        
        Protected Overrides Sub OnLoginError(ByVal e As EventArgs)
            HelpPageText = "Help with logging in..."
            CreateUserText = "Create a new user..."
            PasswordRecoveryText = "Forgot your password?"
        End Sub
        
        Sub New()
            CreateUserUrl = "createUser.aspx"
            HelpPageUrl = "loginHelp.aspx"
            PasswordRecoveryUrl = "getPass.aspx"
        End Sub
        
    End Class
    ' Add the custom login control to the page.
    Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
        Dim loginControl As New CustomLogin

        loginControl.ID = "loginControl"

        PlaceHolder1.Controls.Add(loginControl)
    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:placeholder id="Placeholder1" runat="Server"></asp:placeholder>
</form>
</body>
</html>

Hinweise

Die OnLoginError Methode löst das LoginError Ereignis aus. Verwenden Sie das LoginError Ereignis, um zusätzliche Verarbeitung bereitzustellen, z. B. Fehlerprotokollierung, wenn der Anmeldeversuch eines Benutzers fehlschlägt.

Das Auslösen eines Ereignisses ruft den Ereignishandler über einen Delegaten auf. Weitere Informationen finden Sie unter Behandeln und Auslösen von Ereignissen.

Mit der OnLoginError Methode können abgeleitete Klassen auch das Ereignis behandeln, ohne einen Delegaten anzufügen. Dies ist die bevorzugte Technik für die Behandlung des Ereignisses in einer abgeleiteten Klasse.

Hinweise für Vererber

Achten Sie beim Überschreiben OnLoginError(EventArgs) in einer abgeleiteten Klasse darauf, die Methode der Basisklasse OnLoginError(EventArgs) aufzurufen, damit registrierte Stellvertretungen das Ereignis empfangen.

Gilt für:

Weitere Informationen