TypeValidationEventArgs.Cancel Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origine:

TypeValidationEventArgs.cs

Ottiene o imposta un valore che indica se l'evento deve essere annullato.

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 e lo stato attivo deve essere mantenuto dal MaskedTextBox controllo; in caso contrario, false per continuare l'elaborazione della convalida.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso di questo membro. Nell'esempio un gestore eventi segnala l'occorrenza dell'evento MaskedTextBox.TypeValidationCompleted . Questo report consente di apprendere quando si verifica l'evento e di facilitare il debug. Per segnalare più eventi o eventi che si verificano frequentemente, è consigliabile sostituire MessageBox.Show con Console.WriteLine o accodare il messaggio a un oggetto multilinea TextBox.

Per eseguire il codice di esempio, incollarlo in un progetto contenente un'istanza di tipo MaskedTextBox denominata MaskedTextBox1. Assicurarsi quindi che il gestore eventi sia associato all'evento MaskedTextBox.TypeValidationCompleted .

private void MaskedTextBox1_TypeValidationCompleted(Object sender, TypeValidationEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "Cancel", e.Cancel );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "IsValidInput", e.IsValidInput );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Message", e.Message );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "ReturnValue", e.ReturnValue );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "ValidatingType", e.ValidatingType );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "TypeValidationCompleted Event" );
}

Private Sub MaskedTextBox1_TypeValidationCompleted(sender as Object, e as TypeValidationEventArgs) _ 
     Handles MaskedTextBox1.TypeValidationCompleted

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "Cancel", e.Cancel)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "IsValidInput", e.IsValidInput)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "Message", e.Message)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "ReturnValue", e.ReturnValue)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "ValidatingType", e.ValidatingType)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"TypeValidationCompleted Event")

End Sub

Commenti

L'evento TypeValidationCompleted si verifica subito prima dell'evento Validating .

L'impostazione della Cancel proprietà su true nel TypeValidationCompleted gestore eventi annulla l'evento, causando la conservazione dello stato attivo del MaskedTextBox controllo, a meno che l'evento successivo Validating non imposti la relativa versione della CancelEventArgs.Cancel proprietà su false.

Vedi anche

• TypeValidationCompleted
• Validating