TypeValidationEventArgs.Cancel Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Quelle:

TypeValidationEventArgs.cs

Ruft einen Wert ab, der angibt, ob das Ereignis abgebrochen werden soll, oder legt diesen fest.

public bool Cancel { get; set; }

Eigenschaftswert

Boolean

true, wenn durch das MaskedTextBox-Steuerelement das Ereignis abgebrochen und der Fokus beibehalten werden soll, andernfalls false, um mit dem Validierungsvorgang fortzufahren.

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieses Members veranschaulicht. Im Beispiel meldet ein Ereignishandler das Auftreten des Ereignisses MaskedTextBox.TypeValidationCompleted . Dieser Bericht hilft Ihnen, zu erfahren, wann das Ereignis eintritt, und kann Ihnen beim Debuggen helfen. Um über mehrere Ereignisse oder ereignisse zu berichten, die häufig auftreten, sollten Sie erwägen, die Nachricht durch Console.WriteLine ein mehrzeilesiges TextBoxzu ersetzen MessageBox.Show oder anzufügen.

Um den Beispielcode auszuführen, fügen Sie ihn in ein Projekt ein, das eine instance vom Typ MaskedTextBox enthältMaskedTextBox1. Stellen Sie dann sicher, dass der Ereignishandler dem MaskedTextBox.TypeValidationCompleted Ereignis zugeordnet ist.

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" );
}

Hinweise

Das TypeValidationCompleted Ereignis tritt unmittelbar vor dem Validating Ereignis auf.

Wenn Sie die Cancel -Eigenschaft im TypeValidationCompleted Ereignishandler auf true festlegen, wird das Ereignis abgebrochen, sodass das MaskedTextBox Steuerelement den Fokus behält, es sei denn, das nachfolgende Validating Ereignis legt seine Version der CancelEventArgs.Cancel Eigenschaft auf festfalse.

Gilt für:

Weitere Informationen

• TypeValidationCompleted
• Validating