LoginCancelEventArgs.Cancel Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает значение, показывающее, следует ли отменить событие.
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 BooleanЗначение свойства
Значение true, если событие следует отменить, в противном случае — значение false.
Примеры
В следующем примере кода используется LoggingIn событие , чтобы убедиться, что пользователь ввел правильный адрес электронной почты в свойстве UserName . В противном LoggingIn случае обработчик событий устанавливает Cancel для свойства trueзначение , и отображается сообщение об ошибке. Файл .aspx, который можно использовать для запуска примера, см. в LoginCancelEventArgs разделе .
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
Комментарии
Свойство можно использовать, Cancel чтобы указать, следует ли отменить событие, например LoggingIn событие LoggingOut , событие или ChangingPassword событие.
