LoginCancelEventArgs.Cancel Propriedade

Definição

Obtém ou define um valor que indica se o evento deve ser cancelado.

public bool Cancel { get; set; }

Valor da propriedade

true se o evento deve ser cancelado; caso contrário, false.

Exemplos

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 truee 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;
        }
    }
}

Comentários

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.

Aplica-se a

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

Confira também