LoginCancelEventArgs.Cancel Proprietà

Definizione

Ottiene o imposta un valore che indica se l'evento debba essere annullato.Gets or sets a value indicating whether the event should be canceled.

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

Valore della proprietà

Boolean

true se l'evento deve essere annullato. In caso contrario, false.true if the event should be canceled; otherwise, false.

Esempio

Nell'esempio di codice seguente viene usato l'evento LoggingIn per assicurarsi che l'utente abbia immesso un indirizzo di posta elettronica corretto nella proprietà UserName.The following code example uses the LoggingIn event to ensure that the user has entered a well-formed email address in the UserName property. In caso contrario, il gestore dell'evento LoggingIn imposta la proprietà Cancel su truee viene visualizzato un messaggio di errore.If not, the LoggingIn event handler sets the Cancel property to true, and an error message is displayed. Per un file aspx che può essere usato per eseguire l'esempio, vedere l'argomento LoginCancelEventArgs.For an .aspx file that can be used to run the example, see the LoginCancelEventArgs topic.

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

Commenti

È possibile utilizzare la proprietà Cancel per indicare se è necessario annullare un evento, ad esempio l'evento LoggingIn, l'evento LoggingOut o l'evento ChangingPassword.You can use the Cancel property to indicate whether an event, such as the LoggingIn event, the LoggingOut event, or the ChangingPassword event, should be canceled.

Si applica a

Vedi anche