LoginCancelEventArgs.Cancel Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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, setPublic Property Cancel As BooleanEigenschaftswert
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. Eine .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.
