Login.OnLoginError(EventArgs) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt de LoginError gebeurtenis gegenereerd wanneer een aanmeldingspoging mislukt.
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)
Parameters
Voorbeelden
In het volgende codevoorbeeld wordt de LoginError gebeurtenis gebruikt om Help-koppelingen naar de gebruiker weer te geven wanneer een aanmeldingspoging mislukt.
<%@ 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>
Opmerkingen
Met OnLoginError de methode wordt de LoginError gebeurtenis gegenereerd. Gebruik de LoginError gebeurtenis om aanvullende verwerking te bieden, zoals foutlogboekregistratie, wanneer de aanmeldingspoging van een gebruiker mislukt.
Als u een gebeurtenis aanroept, wordt de gebeurtenis-handler via een gemachtigde aangeroepen. Zie Afhandeling en het genereren van gebeurtenissen voor meer informatie.
Met OnLoginError de methode kunnen afgeleide klassen de gebeurtenis ook verwerken zonder een gemachtigde te koppelen. Dit is de voorkeurstechniek voor het verwerken van de gebeurtenis in een afgeleide klasse.
Notities voor overnemers
Wanneer u OnLoginError(EventArgs) overschrijft in een afgeleide klasse, moet u de methode van OnLoginError(EventArgs) de basisklasse aanroepen, zodat geregistreerde gemachtigden de gebeurtenis ontvangen.