LoginCancelEventArgs.Cancel Eigenschaft

Definition

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.dll

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

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

Boolean

true, wenn das Ereignis abgebrochen werden soll, andernfalls false.

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. Wenn dies nicht der Fall ist, legt der LoggingIn Ereignishandler die Cancel -Eigenschaft auf fest true, und eine Fehlermeldung wird angezeigt. Informationen zu einer ASPX-Datei, die zum Ausführen des Beispiels verwendet werden kann, finden Sie im LoginCancelEventArgs Thema.

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. das LoggingIn Ereignis, das LoggingOut Ereignis oder das ChangingPassword Ereignis, abgebrochen werden soll.

Weitere Informationen

• Login
• LoggingIn
• Übersicht über ASP.NET-Anmeldesteuerelemente