MaskedTextBox.RejectInputOnFirstFailure Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Analyse der Benutzereingabe beendet werden soll, nachdem das erste ungültige Zeichen erreicht wurde.
public:
property bool RejectInputOnFirstFailure { bool get(); void set(bool value); };public bool RejectInputOnFirstFailure { get; set; }member this.RejectInputOnFirstFailure : bool with get, setPublic Property RejectInputOnFirstFailure As BooleanEigenschaftswert
true wenn die Verarbeitung der Eingabezeichenfolge beim ersten Analysefehler beendet werden sollte; false andernfalls sollte die Verarbeitung alle Fehler ignorieren. Der Standardwert lautet false.
Hinweise
Manchmal gibt der Benutzer mehrere Zeichen in einen MaskedTextBox einzelnen Eingabevorgang ein, in der Regel durch Kopieren und Einfügen einer Zeichenfolge. Wenn die gesamte Zeichenfolge nur gültige Zeichen enthält, entsprechend ihrer Einfügeposition im Eingabeformat, wird der gesamte Vorgang erfolgreich ausgeführt. Wenn jedoch ein Analysefehler auftritt, hängt das Verhalten von MaskedTextBox dem Wert von RejectInputOnFirstFailure, wie folgt ab:
Wenn diese Eigenschaft lautet
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 lautet
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 Eigenschaften können auch die Interpretation der Benutzereingabe beeinflussen.
Wenn die IsOverwriteMode Eigenschaft lautet false, werden alle Zeichen, die sich bereits im Eingabeformat rechts neben der Einfügemarke befinden, durch die akzeptierte Anzahl von Zeichen verschoben. Diese Verschiebung kann zu zusätzlichen Analysefehlern führen.
Ein Einzufügenvorgang kann programmgesteuert nachgeahmt werden, indem die SelectedText Eigenschaft festgelegt wird.
