MaskedTextBox.SkipLiterals 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 der Benutzer Literalwerte erneut zurückgeben darf.
public:
property bool SkipLiterals { bool get(); void set(bool value); };public bool SkipLiterals { get; set; }member this.SkipLiterals : bool with get, setPublic Property SkipLiterals As BooleanEigenschaftswert
true literale wiedervererbt werden zu lassen; andernfalls, um zu verhindern, false dass der Benutzer Literalzeichen überschreibt. Der Standardwert lautet true.
Hinweise
Eingabeformate enthalten häufig Literale. Wenn der Benutzer Zeichen zur Laufzeit eingibt MaskedTextBox , fällt die aktuelle Zeichenposition manchmal auf ein Literal. Die SkipLiterals Eigenschaft beschreibt, wie Benutzereingaben für das nächste Zeichen wie folgt behandelt werden sollen:
Wenn diese Eigenschaft lautet
true, kann der Benutzer entweder redundant dasselbe Zeichen wie das Literal an der aktuellen Position eingeben oder das nächste bearbeitbare Zeichen eingeben, wodurch die aktuelle Position an diese Position springt.Wenn diese Eigenschaft lautet
false, kann der Benutzer nur das nächste bearbeitbare Zeichen eingeben. Wenn die nächste Position in der Maske das Literalzeichen nicht akzeptiert (z. B. gibt der Benutzer "/" ein, und die nächste Position akzeptiert nur Ziffern), löst das Steuerelement das MaskInputRejected Ereignis aus.
Beispielsweise sind im Datumseingabeformat "90/90/0000" die Schrägstrichzeichen Literale. Gehen Sie davon aus, dass der Benutzer zwei Anfangsziffern (11) eingegeben hat, sodass sich die aktuelle Position im Maskenformat am ersten Schrägstrich (/) befindet. Wenn SkipLiterals ja true, hat der Benutzer die folgenden gültigen Optionen:
Der Benutzer kann ein "/"-Zeichen eingeben. Dies führt dazu, dass die Position in das nächste Zeichen verschoben wird, bei dem es sich in diesem Beispiel um die vierte Position handelt, um ein 9 maskierendes Element.
Der Benutzer kann das nächste bearbeitbare Zeichen eingeben, bei dem es sich in diesem Beispiel um eine Ziffer handelt. Die Ziffer wird überprüft, und die aktuelle Position wird automatisch an die fünfte Position verschoben, bei der es sich um ein 0 Maskierungselement handelt.
Wenn SkipLiterals dies der Fall ist, ist falsenur eine gültige Dateneingabe zulässig, was in diesem Beispiel eine Ziffer sein würde.
