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.
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, setPublic Property RejectInputOnFirstFailure As BooleanEigenschaftswert
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.
