PasswordRecovery.OnUserLookupError(EventArgs) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Raises the UserLookupError event.
protected:
virtual void OnUserLookupError(EventArgs ^ e);
protected virtual void OnUserLookupError (EventArgs e);
abstract member OnUserLookupError : EventArgs -> unit
override this.OnUserLookupError : EventArgs -> unit
Protected Overridable Sub OnUserLookupError (e As EventArgs)
Parameters
Examples
The following code example defines a custom PasswordRecovery control that overrides the OnUserLookupError method to change the UserNameTitleText property if the user enters an incorrect answer to the password confirmation question.
<%@ 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">
class CustomPasswordRecovery : PasswordRecovery
{
override protected void OnAnswerLookupError(EventArgs e)
{
QuestionTitleText = "Try again";
TitleTextStyle.ForeColor = System.Drawing.Color.Red;
base.OnAnswerLookupError(e);
}
}
// Add the custom password recovery control to the page.
void Page_Init(object sender, EventArgs e)
{
CustomPasswordRecovery passwordRecoveryControl = new CustomPasswordRecovery();
passwordRecoveryControl.ID = "passwordRecoveryControl";
PlaceHolder1.Controls.Add(passwordRecoveryControl);
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<p>
<asp:placeholder id="PlaceHolder1" runat="server"></asp:placeholder> </p>
</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">
Class CustomPasswordRecovery
Inherits PasswordRecovery
Overloads Sub OnAnswerLookupError(ByVal e As EventArgs)
QuestionTitleText = "Try again"
TitleTextStyle.ForeColor = System.Drawing.Color.Red
MyBase.OnAnswerLookupError(e)
End Sub
End Class
' Add the custom password recovery control to the page.
Sub Page_Init(ByVal sender As Object, ByVal e As EventArgs)
Dim passwordRecoveryControl As New CustomPasswordRecovery
passwordRecoveryControl.ID = "passwordRecoveryControl"
PlaceHolder1.Controls.Add(passwordRecoveryControl)
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">
<p>
<asp:placeholder id="PlaceHolder1" runat="server"></asp:placeholder> </p>
</form>
</body>
</html>
Remarks
The OnUserLookupError method is called when the membership provider is unable to find the user name entered on the initial screen. The default implementation raises the UserLookupError event.
Raising an event invokes the event handler through a delegate. For more information, see Handling and Raising Events.
The OnUserLookupError method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.
Notes to Inheritors
When overriding OnUserLookupError(EventArgs) in a derived class, be sure to call the base class's OnUserLookupError(EventArgs) method so that registered delegates receive the event.