TypeValidationEventArgs.Cancel Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de gebeurtenis moet worden geannuleerd.
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 BooleanWaarde van eigenschap
true als de gebeurtenis moet worden geannuleerd en de focus moet worden bewaard door het MaskedTextBox besturingselement, anders om false de validatie te blijven verwerken.
Voorbeelden
In het volgende codevoorbeeld ziet u het gebruik van dit lid. In het voorbeeld rapporteert een gebeurtenis-handler over het optreden van de MaskedTextBox.TypeValidationCompleted gebeurtenis. Dit rapport helpt u te leren wanneer de gebeurtenis plaatsvindt en u kan helpen bij het opsporen van fouten. Als u wilt rapporteren over meerdere gebeurtenissen of gebeurtenissen die vaak optreden, kunt u overwegen het bericht te vervangen MessageBox.ShowConsole.WriteLine door of toe te voegen aan een multiline TextBox.
Als u de voorbeeldcode wilt uitvoeren, plakt u deze in een project dat een exemplaar van het type MaskedTextBox met de naam MaskedTextBox1bevat. Zorg er vervolgens voor dat de gebeurtenis-handler is gekoppeld aan de MaskedTextBox.TypeValidationCompleted gebeurtenis.
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
Opmerkingen
De TypeValidationCompleted gebeurtenis vindt plaats vlak voor de Validating gebeurtenis.
Als u de Cancel eigenschap true instelt in de TypeValidationCompleted gebeurtenis-handler, wordt de gebeurtenis geannuleerd, waardoor het besturingselement de MaskedTextBox focus behoudt, tenzij de volgende Validating gebeurtenis de versie van de CancelEventArgs.Cancel eigenschap instelt op false.
