LoginCancelEventArgs LoginCancelEventArgs LoginCancelEventArgs LoginCancelEventArgs Class

Definition

Stellt Daten für ein abbrechbares Ereignis bereit.Provides data for a cancelable event.

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

Beispiele

Im folgenden Codebeispiel wird das LoggingIn -Ereignis verwendet, um sicherzustellen, dass der Benutzer eine wohlgeformte e- UserName Mail-Adresse in der-Eigenschaft eingegeben hat.The following code example uses the LoggingIn event to ensure that the user has entered a well-formed email address in the UserName property. Wenn dies nicht der LoggingIn Fall ist, bricht der Ereignishandler den Anmeldeversuch Cancel ab, indem LoginCancelEventArgs die- trueEigenschaft des-Objekts auf festgelegt wird. Anschließend wird die in der InstructionText -Eigenschaft angegebene Fehlermeldung angezeigt.If not, the LoggingIn event handler cancels the logon attempt by setting the Cancel property of the LoginCancelEventArgs object to true.Then the error message specified in the InstructionText property is displayed.

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 verwendet werden kann, um das vorherige Beispiel auszuführen.The following is the .aspx file that can be used to run the preceding example.

<%@ 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 abgebrochen-Ereignis wird ausgelöst, wenn eine Komponente im Begriff ist, eine Aktion auszuführen, die abgebrochen werden kann, z. b. die Anmeldung bei einer Website.A cancelable event is raised when a component is about to perform an action that can be canceled, such as logging on to a Web site.

Die LoginCancelEventArgs -Klasse stellt Cancel die-Eigenschaft bereit, um anzugeben, ob das Ereignis abgebrochen werden soll.The LoginCancelEventArgs class provides the Cancel property to indicate whether the event should be canceled. Ein LoginCancelEventArgs -Objekt wird mit Steuerelementen verwendet, die abbrechbare Aktionen wie Login das-Steuer CreateUserWizard Element, das- PasswordRecovery Steuerelement und das-Steuerelement aufweisen.A LoginCancelEventArgs object is used with controls that have cancelable actions, such as the Login control, the CreateUserWizard control, and the PasswordRecovery control.

Konstruktoren

LoginCancelEventArgs() LoginCancelEventArgs() LoginCancelEventArgs() LoginCancelEventArgs()

Initialisiert eine neue Instanz der LoginCancelEventArgs-Klasse, wobei die Cancel-Eigenschaft auf false festgelegt ist.Initializes a new instance of the LoginCancelEventArgs class with the Cancel property set to false.

LoginCancelEventArgs(Boolean) LoginCancelEventArgs(Boolean) LoginCancelEventArgs(Boolean) LoginCancelEventArgs(Boolean)

Initialisiert eine neue Instanz der LoginCancelEventArgs-Klasse, wobei die Cancel-Eigenschaft auf den angegebenen Wert festgelegt ist.Initializes a new instance of the LoginCancelEventArgs class with the Cancel property set to the specified value.

Eigenschaften

Cancel Cancel Cancel Cancel

Ruft einen Wert ab, der angibt, ob das Ereignis abgebrochen werden soll, oder legt diesen fest.Gets or sets a value indicating whether the event should be canceled.

Methoden

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Gilt für:

Siehe auch