Freigeben über


LoginCancelEventArgs Klasse

Definition

Stellt Daten für ein abbrechbares Ereignis bereit.

public ref class LoginCancelEventArgs : EventArgs
public class LoginCancelEventArgs : EventArgs
type LoginCancelEventArgs = class
    inherit EventArgs
Public Class LoginCancelEventArgs
Inherits EventArgs
Vererbung
LoginCancelEventArgs
Abgeleitet

Beispiele

Im folgenden Codebeispiel wird das LoggingIn -Ereignis verwendet, um sicherzustellen, dass der Benutzer eine wohlgeformte E-Mail-Adresse in die UserName -Eigenschaft eingegeben hat. Andernfalls bricht der LoggingIn Ereignishandler den Anmeldeversuch ab, indem er die Cancel -Eigenschaft des LoginCancelEventArgs -Objekts auf truefestlegt. Anschließend wird die in der InstructionText -Eigenschaft angegebene Fehlermeldung angezeigt.

public partial class LoginCancelEventArgscs_aspx : System.Web.UI.Page
{

    bool IsValidEmail(string strIn)
    {
        // Return true if strIn is in valid email format.
        return System.Text.RegularExpressions.Regex.IsMatch(strIn, 
            @"^([\w-\.]+)@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.)|(([\w-]+\.)+))([a-zA-Z]{2,4}|[0-9]{1,3})(\]?)$");
    }
    
    protected void OnLoggingIn(object sender, System.Web.UI.WebControls.LoginCancelEventArgs e)
    {
        if (!IsValidEmail(Login1.UserName))
        {
            Login1.InstructionText = "You must enter a valid email address.";
            e.Cancel = true;
        }
        else
        {
            Login1.InstructionText = String.Empty;
        }
    }
}
Partial Class LoginCancelEventArgsvb_aspx
    Inherits System.Web.UI.Page

    Function IsValidEmail(ByVal strIn As String) As Boolean
        ' Return true if strIn is in valid email format.
        Return Regex.IsMatch(strIn, _
            ("^([\w-\.]+)@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.)|(([\w-]+\.)+))([a-zA-Z]{2,4}|[0-9]{1,3})(\]?)$"))
    End Function

    Protected Sub OnLoggingIn(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.LoginCancelEventArgs)
        If Not IsValidEmail(Login1.UserName) Then
            Login1.InstructionText = "You must enter a valid email address."
            e.Cancel = True
        Else
            Login1.InstructionText = String.Empty
        End If
    End Sub

End Class

Im Folgenden finden Sie die .aspx-Datei, die zum Ausführen des vorherigen Beispiels verwendet werden kann.

<%@ Page Language="C#" CodeFile="LoginCancelEventArgs.cs" Inherits="LoginCancelEventArgscs_aspx" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="Form1" runat="server">
            <asp:Login id="Login1" 
              runat="server" 
              onloggingin="OnLoggingIn">
            </asp:Login>
        </form>
    </body>
</html>
<%@ Page Language="VB" AutoEventWireup="false" CodeFile="LoginCancelEventArgs.vb" Inherits="LoginCancelEventArgsvb_aspx" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="Form1" runat="server">
            <asp:Login id="Login1" 
              runat="server" 
              onloggingin="OnLoggingIn">
            </asp:Login>
        </form>
    </body>
</html>

Hinweise

Ein abbruchbares Ereignis wird ausgelöst, wenn eine Komponente eine Aktion ausführt, die abgebrochen werden kann, z. B. die Anmeldung bei einer Website.

Die LoginCancelEventArgs -Klasse stellt die Cancel -Eigenschaft bereit, um anzugeben, ob das Ereignis abgebrochen werden soll. Ein LoginCancelEventArgs -Objekt wird mit Steuerelementen verwendet, die über abbruchbare Aktionen verfügen, z. B. das Login Steuerelement, das CreateUserWizard Steuerelement und das PasswordRecovery Steuerelement.

Konstruktoren

LoginCancelEventArgs()

Initialisiert eine neue Instanz der LoginCancelEventArgs-Klasse, wobei die Cancel-Eigenschaft auf false festgelegt ist.

LoginCancelEventArgs(Boolean)

Initialisiert eine neue Instanz der LoginCancelEventArgs-Klasse, wobei die Cancel-Eigenschaft auf den angegebenen Wert festgelegt ist.

Eigenschaften

Cancel

Ruft einen Wert ab, der angibt, ob das Ereignis abgebrochen werden soll, oder legt diesen fest.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Gilt für:

Weitere Informationen