Login.OnLoginError(EventArgs) 方法

  • 參考

定義

命名空間:
System.Web.UI.WebControls
組件:
System.Web.dll

登入嘗試失敗時，會引發 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)

參數

e
EventArgs

包含事件資料的 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) 方法，使已註冊的委派能接收到事件。

適用於

另請參閱