LoginCancelEventArgs.Cancel Propriedade
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define um valor que indica se o evento deve ser cancelado.
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
true
se o evento deve ser cancelado; caso contrário, false
.
O exemplo de código a seguir usa o LoggingIn evento para garantir que o usuário insira um endereço de email bem formado na UserName propriedade . Caso contrário, o LoggingIn manipulador de eventos define a Cancel propriedade como true
e uma mensagem de erro é exibida. Para obter um arquivo .aspx que pode ser usado para executar o exemplo, consulte o LoginCancelEventArgs tópico .
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
Você pode usar a Cancel propriedade para indicar se um evento, como o LoggingIn evento, o LoggingOut evento ou o ChangingPassword evento, deve ser cancelado.
Produto | Versões |
---|---|
.NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
Comentários do .NET
O .NET é um projeto código aberto. Selecione um link para fornecer comentários: