Login.OnLoginError(EventArgs) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
登入嘗試失敗時,會引發 LoginError 事件。
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)
參數
範例
下列程式代碼範例會 LoginError 使用 事件,在登入嘗試失敗時顯示使用者的說明連結。
<%@ 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>
備註
OnLoginError 方法會引發 LoginError 事件。 當使用者 LoginError 的登入嘗試失敗時,請使用 事件來提供其他處理,例如錯誤記錄。
引發事件會透過委派叫用此事件處理常式。 如需詳細資訊,請參閱 處理和引發事件。
OnLoginError 方法也允許衍生類別處理事件,而不用附加委派。 這是在衍生類別中處理事件的慣用技巧。
給繼承者的注意事項
當在衍生類別中覆寫 OnLoginError(EventArgs) 時,請確定呼叫基底類別的 OnLoginError(EventArgs) 方法,使已註冊的委派能接收到事件。