MaskedTextBox.Mask Eigenschaft

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Ruft die zur Laufzeit zu verwendende Eingabemaske ab oder legt diese fest.

public:
 property System::String ^ Mask { System::String ^ get(); void set(System::String ^ value); };
public string Mask { get; set; }
member this.Mask : string with get, set
Public Property Mask As String

Eigenschaftswert

String

Eine String, die die aktuelle Maske darstellt. Der Standardwert ist eine leere Zeichenfolge, die jede Eingabe ermöglicht.

Ausnahmen

ArgumentException

Die an die Mask-Eigenschaft übergebene Zeichenfolge stellt keine gültige Maske dar. Ungültige Masken schließen Masken ein, die nicht druckbare Zeichen enthalten.

Hinweise

Mask ist die Standardeigenschaft für die MaskedTextBox -Klasse.

Mask muss eine Zeichenfolge sein, die aus mindestens einem der Maskierungselemente besteht, wie in der folgenden Tabelle gezeigt. Die von MaskedTextBox verwendete Maskierungssprache wird durch die zugeordnete MaskedTextProviderdefiniert. Der Standardanbieter gibt eine Maskierungssprache basierend auf der sprache an, die vom Steuerelement Masked Edit in Visual Basic 6.0 verwendet wird, und sollte Benutzern, die von dieser Plattform migrieren, sehr vertraut sein.

Masking-Element BESCHREIBUNG
0 Zahl, erforderlich. Dieses Element akzeptiert jede einzelne Ziffer zwischen 0 und 9.
9 Ziffer oder Leerzeichen, optional.
# Ziffer oder Leerzeichen, optional. Wenn diese Position in der Maske leer ist, wird sie als Leerzeichen in der Text Eigenschaft gerendert. Pluszeichen (+) und Minuszeichen (-) sind zulässig.
L Brief, erforderlich. Beschränkt die Eingabe auf die ASCII-Buchstaben a-z und A-Z. Dieses Maskenelement entspricht [a-zA-Z] in regulären Ausdrücken.
? Brief, optional. Beschränkt die Eingabe auf die ASCII-Buchstaben a-z und A-Z. Dieses Maskenelement entspricht [a-zA-Z]? in regulären Ausdrücken.
& Zeichen, erforderlich. Wenn die AsciiOnly Eigenschaft auf true festgelegt ist, verhält sich dieses Element wie das "L"-Element.
C Zeichen, optional. Alle Nicht-Steuerungszeichen. Wenn die AsciiOnly -Eigenschaft auf truefestgelegt ist, verhält sich dieses Element wie das Element "?".
Ein Alphanumerisch, erforderlich. Wenn die AsciiOnly -Eigenschaft auf truefestgelegt ist, werden nur die ASCII-Buchstaben a-z und A-Z akzeptiert. Dieses Maskenelement verhält sich wie das Element "a".
a Alphanumerisch, optional. Wenn die AsciiOnly -Eigenschaft auf truefestgelegt ist, werden nur die ASCII-Buchstaben a-z und A-Z akzeptiert. Dieses Maskenelement verhält sich wie das "A"-Element.
. Dezimalplatzhalter. Das tatsächliche Anzeigezeichen ist das dezimale Symbol, das dem Formatanbieter entspricht, wie es durch die -Eigenschaft des Steuerelements FormatProvider bestimmt wird.
, Tausende Platzhalter. Das tatsächliche Anzeigezeichen ist der für den Formatanbieter geeignete Tausender-Platzhalter, der durch die -Eigenschaft des Steuerelements FormatProvider bestimmt wird.
: Zeittrennzeichen. Das tatsächliche Anzeigezeichen ist das für den Formatanbieter geeignete Zeitsymbol, das durch die Eigenschaft des Steuerelements FormatProvider bestimmt wird.
/ Datumstrennzeichen. Das tatsächliche Anzeigezeichen ist das Datumssymbol, das für den Formatanbieter geeignet ist, wie es durch die -Eigenschaft des Steuerelements FormatProvider bestimmt wird.
$ Währungssymbol. Das tatsächliche Zeichen, das angezeigt wird, ist das Währungssymbol, das für den Formatanbieter geeignet ist, wie es durch die -Eigenschaft des Steuerelements FormatProvider bestimmt wird.
< Umschalten nach unten. Konvertiert alle nachfolgenden Zeichen in Kleinbuchstaben.
> Umschalten nach oben. Konvertiert alle nachfolgenden Zeichen in Großbuchstaben.
| Deaktivieren Sie eine vorherige Verschiebung nach oben oder nach unten.
\ Flucht. Escapet ein Maskenzeichen, wodurch es in ein Literal umgewandelt wird. "\\" ist die Escapesequenz für einen umgekehrten Schrägstrich.
Alle anderen Zeichen Literale. Alle Elemente, die nicht maskieren, werden als sich selbst in MaskedTextBox angezeigt. Literale nehmen zur Laufzeit immer eine statische Position in der Maske ein und können vom Benutzer nicht verschoben oder gelöscht werden.

Wenn Sie eine Maske ändern, wenn MaskedTextBox bereits Benutzereingaben enthalten, die nach einer vorherigen Maske gefiltert wurden, MaskedTextBox versucht, diese Eingabe in die neue Maskendefinition zu migrieren. Wenn ein Fehler auftritt, wird die vorhandene Eingabe gelöscht. Durch Zuweisen einer Zeichenfolge der Länge null als Maske bleiben alle vorhandenen Daten im Steuerelement erhalten. Verhält sich bei Verwendung mit einer Maske MaskedTextBox der Länge null wie ein einzeiliges TextBox Steuerelement.

Die Dezimalzeichen (.), Tausendstel (,), Uhrzeit (:), Datum (/) und Währungssymbole ($) zeigen standardmäßig diese Symbole gemäß Definition der Kultur der Anwendung an. Sie können sie erzwingen, Symbole für eine andere Kultur mithilfe der FormatProvider Eigenschaft anzuzeigen.

Das Einfügen von Zeichen in die Maske zur Laufzeit wird von der InsertKeyMode -Eigenschaft gesteuert. Benutzer können durch die Maske navigieren, indem sie die Nach-links- und nach-rechts-Taste oder den Mauscursor verwenden, und optionale Positionen in der Maske überspringen, indem sie ein Leerzeichen eingeben.

Wichtig

MaskedTextBox unterstützt alle Unicode-Zeichen mit Ausnahme von Ersatzzeichen und vertikal kombinierten Zeichen.

Die folgende Tabelle zeigt Beispielmasken.

Mask Verhalten
00/00/0000 Ein Datum (Tag, numerischer Monat, Jahr) im internationalen Datumsformat. Das Zeichen "/" ist ein logisches Datumstrennzeichen und wird dem Benutzer als Datumstrennzeichen angezeigt, das der aktuellen Kultur der Anwendung entspricht.
00->L<LL-0000 Ein Datum (Tag, Monatskürzel und Jahr) im US-Amerikanischen Format, in dem die Abkürzung für den Monat mit drei Buchstaben mit einem ersten Großbuchstaben angezeigt wird, gefolgt von zwei Kleinbuchstaben.
(999)-000-0000 US-amerikanische Telefonnummer, Ortsvorwahl optional. Wenn Benutzer die optionalen Zeichen nicht eingeben möchten, können sie entweder Leerzeichen eingeben oder den Mauszeiger direkt an der Position in der Maske platzieren, die durch die erste 0 dargestellt wird.
$999,999.00 Ein Währungswert im Bereich von 0 bis 999999. Die Währungs-, Tausendstel- und Dezimalzeichen werden zur Laufzeit durch ihre kulturspezifischen Entsprechungen ersetzt.

Gilt für:

Weitere Informationen