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.
Ruft einen Wert ab, der angibt, ob literale Werte erneut eingegeben werden können, oder legt diesen fest.
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, damit Literale erneut eingegeben werden können, andernfalls false, damit Literalzeichen nicht überschrieben werden können. Der Standardwert ist true.
Hinweise
Eingabemasken enthalten häufig Literale. Wenn der Benutzer Zeichen zur MaskedTextBox Laufzeit eingibt, fällt die aktuelle Zeichenposition manchmal auf ein Literal. Die SkipLiterals Eigenschaft beschreibt, wie benutzereingaben für das nächste Zeichen behandelt werden sollen, wie folgt:
Wenn diese Eigenschaft lautet
true, kann der Benutzer entweder redundant das gleiche Zeichen wie das Literal an der aktuellen Position eingeben oder das nächste bearbeitbare Zeichen eingeben, wodurch die aktuelle Position zu dieser 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.
Beispiel: Im Datumseintragsformat "90/90/0000" sind die Schrägstrichzeichen Literale. Angenommen, der Benutzer hat zwei Anfängliche Ziffern eingegeben, "11", sodass die aktuelle Position in der Maske am ersten Schrägstrich (/) Literal liegt. trueWenn SkipLiterals es sich handelt, 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, was in diesem Beispiel die vierte Position ist, ein 9-Maskierungselement.
Der Benutzer kann das nächste bearbeitbare Zeichen eingeben, das in diesem Beispiel eine Ziffer ist. Die Ziffer würde überprüft und die aktuelle Position wird automatisch an die fünfte Position verschoben, was ein 0-Maskierungselement ist.
falseWenn SkipLiterals es sich um eine gültige Dateneingabe handelt, ist nur eine gültige Dateneingabe zulässig, die in diesem Beispiel eine Zahl sein würde.