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.
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Ereignis abgebrochen werden soll.
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
truewenn 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. Andernfalls legt der LoggingIn Ereignishandler die Cancel Eigenschaft auf true, und es wird eine Fehlermeldung 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
Mit der Cancel Eigenschaft können Sie angeben, ob ein Ereignis, z. B. das LoggingIn Ereignis, das LoggingOut Ereignis oder das ChangingPassword Ereignis, abgebrochen werden soll.
