Login.OnLoginError(EventArgs) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
LoginError Zgłasza zdarzenie, gdy próba logowania kończy się niepowodzeniem.
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)
Parametry
Przykłady
Poniższy przykład kodu używa LoginError zdarzenia, aby wyświetlić linki Pomocy do użytkownika, gdy próba logowania zakończy się niepowodzeniem.
<%@ 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>
Uwagi
Metoda OnLoginError zgłasza LoginError zdarzenie. LoginError Użyj zdarzenia, aby zapewnić dodatkowe przetwarzanie, takie jak rejestrowanie błędów, gdy próba logowania użytkownika zakończy się niepowodzeniem.
Podnoszenie zdarzenia wywołuje program obsługi zdarzeń przez delegata. Aby uzyskać więcej informacji, zobacz Obsługa i podnoszenie zdarzeń.
Metoda OnLoginError umożliwia również klasom pochodnym obsługę zdarzenia bez dołączania delegata. Jest to preferowana technika obsługi zdarzenia w klasie pochodnej.
Uwagi dotyczące dziedziczenia
Podczas zastępowania OnLoginError(EventArgs) w klasie pochodnej należy wywołać metodę klasy OnLoginError(EventArgs) bazowej, aby zarejestrowani delegaci otrzymywali zdarzenie.