Freigeben über


MaskedTextBox.RejectInputOnFirstFailure Eigenschaft

Definition

Ruft einen Wert ab, der angibt, ob die Analyse der Benutzereingabe unterbrochen werden soll, wenn das erste ungültige Zeichen erreicht ist, oder legt diesen fest.

public:
 property bool RejectInputOnFirstFailure { bool get(); void set(bool value); };
public bool RejectInputOnFirstFailure { get; set; }
member this.RejectInputOnFirstFailure : bool with get, set
Public Property RejectInputOnFirstFailure As Boolean

Eigenschaftswert

true, wenn die Verarbeitung der Eingabezeichenfolge beim ersten Analysefehler beendet werden soll, false, wenn alle Fehler durch die Verarbeitung ignoriert werden sollen. Der Standardwert ist false.

Hinweise

Manchmal gibt der Benutzer in einem MaskedTextBox einzelnen Eingabevorgang mehrere Zeichen ein, in der Regel durch Kopieren und Einfügen einer Zeichenfolge. Wenn die gesamte Zeichenfolge gemäß ihrer Einfügeposition im Eingabeformat nur gültige Zeichen enthält, ist der gesamte Vorgang erfolgreich. Wenn jedoch ein Analysefehler auftritt, hängt das Verhalten von MaskedTextBox wie folgt vom Wert von RejectInputOnFirstFailureab:

  • Wenn diese Eigenschaft ist true, wird die Verarbeitung der Eingabezeichenfolge beim ungültigen Zeichen beendet. Alle nachfolgenden Zeichen werden ignoriert. Ein einzelnes MaskInputRejected Ereignis wird ausgelöst.

  • Wenn diese Eigenschaft ist false, wird das ungültige Zeichen abgelehnt, die Analyse wird jedoch mit dem nächsten Zeichen in der Eingabezeichenfolge fortgesetzt. Für jedes ungültige Zeichen in der Eingabezeichenfolge wird ein MaskInputRejected Ereignis ausgelöst.

Die ResetOnPromptEigenschaften , ResetOnSpace und SkipLiterals können auch die Interpretation der Benutzereingabe beeinflussen.

Wenn die IsOverwriteMode -Eigenschaft ist false, werden alle Zeichen, die sich bereits im Eingabeformat rechts neben der Einfügemarke befinden, um die zulässige Anzahl von Zeichen verschoben. Diese Verschiebung kann zu zusätzlichen Analysefehlern führen.

Ein Einstellvorgang kann programmgesteuert nachgeahmt werden, indem die SelectedText -Eigenschaft festgelegt wird.

Gilt für:

Weitere Informationen