LoginCancelEventArgs.Cancel Eigenschaft

Definition

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.

public:
 property bool Cancel { bool get(); void set(bool value); };
public bool Cancel { get; set; }
member this.Cancel : bool with get, set
Public Property Cancel As Boolean

Eigenschaftswert

true, wenn das Ereignis abgebrochen werden soll, andernfalls false.true if the event should be canceled; otherwise, false.

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. Andernfalls legt der LoggingIn Ereignishandler die Cancel -Eigenschaft auf truefest, und es wird eine Fehlermeldung angezeigt.If not, the LoggingIn event handler sets the Cancel property to true, and an error message is displayed. Eine ASPX-Datei, die zum Ausführen des Beispiels verwendet werden kann, finden Sie LoginCancelEventArgs im Thema.For an .aspx file that can be used to run the example, see the LoginCancelEventArgs topic.

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

Hinweise

Sie können die Cancel -Eigenschaft verwenden, um anzugeben, ob ein Ereignis, z. b LoggingOut . das LoggingIn -Ereignis ChangingPassword , das-Ereignis oder das-Ereignis, abgebrochen werden soll.You can use the Cancel property to indicate whether an event, such as the LoggingIn event, the LoggingOut event, or the ChangingPassword event, should be canceled.

Gilt für:

Siehe auch