MaskedTextBox.Mask Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

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 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 einem oder mehreren der Maskierungselemente besteht, wie in der folgenden Tabelle gezeigt. Die von verwendete MaskedTextBox Maskierungssprache wird durch die zugeordnete MaskedTextProviderdefiniert. Der Standardanbieter gibt eine Maskierungssprache an, die auf der vom Steuerelement "Maskierte Bearbeitung" in Visual Basic 6.0 verwendeten Sprache basiert, und sollte Benutzern, die von dieser Plattform migrieren, sehr vertraut sein.

Maskierungselement	BESCHREIBUNG
0	Ziffer, 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	Buchstabe, 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.
?	Buchstabe, 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. Ein beliebiges Nicht-Steuerelementzeichen. Wenn die AsciiOnly -Eigenschaft auf `true`festgelegt ist, verhält sich dieses Element wie das "?"-Element.
Ein	Alphanumerisch, erforderlich. Wenn die AsciiOnly -Eigenschaft auf `true`festgelegt ist, werden nur die ASCII-Buchstaben a-z und A-Z akzeptiert. Dieses Maskenelement verhält sich wie das "a"-Element.
a	Alphanumerisch, optional. Wenn die AsciiOnly -Eigenschaft auf `true`festgelegt 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 für den Formatanbieter geeignet ist, wie es von der -Eigenschaft des Steuerelements FormatProvider bestimmt wird.
,	Tausender-Platzhalter. Das tatsächlich verwendete Anzeigezeichen ist der Platzhalter für Tausende, der für den Formatanbieter geeignet ist, wie durch die -Eigenschaft des Steuerelements FormatProvider bestimmt.
:	Zeittrennzeichen. Das tatsächliche Anzeigezeichen ist das zeitgerechte Symbol für den Formatanbieter, 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 von der -Eigenschaft des Steuerelements FormatProvider bestimmt wird.
$	Währungssymbol. Das tatsächliche Angezeigte Zeichen ist das Währungssymbol, das für den Formatanbieter geeignet ist, wie es von der -Eigenschaft des Steuerelements FormatProvider bestimmt wird.
<	Umschalten nach unten. Konvertiert alle folgenden Zeichen in Kleinbuchstaben.
>	Nach oben verschieben. Konvertiert alle folgenden Zeichen in Großbuchstaben.
\|	Deaktivieren Sie eine vorherige Verschiebung nach oben oder nach unten.
\	Flucht. Escapen eines Maskenzeichens und wandeln es in ein Literal um. "\\" ist die Escapesequenz für einen umgekehrten Schrägstrich.
Alle anderen Zeichen	Literale. Alle Nicht-Mask-Elemente werden in MaskedTextBoxals sich selbst 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, versucht, MaskedTextBox diese Eingabe in die neue Maskendefinition zu migrieren. Wenn ein Fehler auftritt, wird die vorhandene Eingabe gelöscht. Wenn Sie als Maske eine Zeichenfolge der Länge Null zuweisen, bleiben alle vorhandenen Daten im Steuerelement erhalten. Bei Verwendung mit einer Maske MaskedTextBox der Länge Null verhält sich wie ein einzeiliges TextBox Steuerelement.

Die Symbole dezimal (.), Tausendstel (,), Uhrzeit (:), Datum (/) und Währung ($) werden standardmäßig gemäß der Kultur der Anwendung angezeigt. Sie können erzwingen, dass symbole für eine andere Kultur angezeigt werden, indem Sie die FormatProvider -Eigenschaft verwenden.

Das Einfügen von Zeichen in die Maske zur Laufzeit wird durch die InsertKeyMode -Eigenschaft gesteuert. Benutzer können durch die Maske navigieren, indem sie die NACH-LINKS- und NACH-RECHTS-TASTE oder den Mauszeiger 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) in USA Format, in dem die Drei-Buchstaben-Monatskürzel mit einem Anfangsbuchstaben, gefolgt von zwei Kleinbuchstaben, angezeigt wird.
`(999)-000-0000`	USA 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: