MaskedTextBox.Mask 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 das Eingabeformat ab, das zur Laufzeit verwendet werden soll, oder legt dieses 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, setPublic Property Mask As StringEigenschaftswert
A String representing the current mask. Der Standardwert ist die leere Zeichenfolge, die eingaben zulässt.
Ausnahmen
Die für die Mask Eigenschaft bereitgestellte Zeichenfolge ist keine gültige Maske. Ungültige Masken enthalten Masken, 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 Maskierungselementen besteht, wie in der folgenden Tabelle dargestellt. Die von MaskedTextBox ihnen verwendete Maskierungssprache wird durch die zugeordnete MaskedTextProviderSprache definiert. Der Standardanbieter gibt eine Maskierungssprache basierend auf dem Formatierungssprache an, das vom Steuerelement "Maskierte Bearbeitung" in Visual Basic 6.0 verwendet wird, und sollte benutzern, die von dieser Plattform migrieren, sehr vertraut sein.
| Masking-Element | Beschreibung |
|---|---|
| 0 | Ziffer, erforderlich. Dieses Element akzeptiert jede einzelne Ziffer zwischen 0 und 9. |
| 9 | Ziffern oder Leerzeichen, optional. |
| # | Ziffern 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. Schränkt eingaben auf die ASCII-Buchstaben a-z und A-Z ein. Dieses Maskenelement entspricht [a-zA-Z] in regulären Ausdrücken. |
| ? | Buchstabe, optional. Schränkt eingaben auf die ASCII-Buchstaben a-z und A-Z ein. 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. |
| A | Alphanumerisch, erforderlich. Wenn die |
| a | Alphanumerisch, optional. Wenn die |
| . | Dezimalplatzhalter. Das tatsächliche verwendete Anzeigezeichen ist das dezimale Symbol, das dem Formatanbieter entsprechend der Eigenschaft des Steuerelements FormatProvider entspricht. |
| , | Tausenderplatzhalter. Das tatsächliche verwendete Anzeigezeichen ist der Tausenderplatzhalter, der für den Formatanbieter geeignet ist, wie durch die Eigenschaft des Steuerelements FormatProvider bestimmt. |
| : | Zeittrennzeichen. Das tatsächliche verwendete Anzeigezeichen ist das Zeitsymbol, das dem Formatanbieter entsprechend der Eigenschaft des Steuerelements FormatProvider entspricht. |
| / | Datumstrennzeichen. Das tatsächliche verwendete Anzeigezeichen ist das Datumssymbol, das dem Formatanbieter entsprechend der Eigenschaft des Steuerelements FormatProvider entspricht. |
| $ | Das Währungssymbol. Das tatsächliche angezeigte Zeichen ist das Währungssymbol, das dem Formatanbieter entsprechend der Eigenschaft des Steuerelements FormatProvider entspricht. |
| < | Umschalten nach unten. Konvertiert alle nachfolgenden Zeichen in Kleinbuchstaben. |
| > | Umschalt nach oben. Konvertiert alle nachfolgenden Zeichen in Großbuchstaben. |
| | | Deaktivieren Sie eine vorherige Schicht 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 nicht maskierten Elemente werden in ihrer ursprünglichen Form innerhalb MaskedTextBox angezeigt. Literale belegen immer eine statische Position in der Maske zur Laufzeit und können vom Benutzer nicht verschoben oder gelöscht werden. |
Wenn Sie eine Maske ändern, wenn MaskedTextBox bereits Benutzereingaben nach einer vorherigen Maske gefiltert sind, wird versucht, MaskedTextBox diese Eingabe in die neue Maskendefinition zu migrieren. Wenn ein Fehler auftritt, wird die vorhandene Eingabe gelöscht. Wenn Sie eine Zeichenfolge der Länge Null zuweisen, da die Maske alle vorhandenen Daten im Steuerelement behält. Bei Verwendung mit einer Maske MaskedTextBox der Länge Null verhält sich das Verhalten wie ein einzeiliges TextBox Steuerelement.
Die Dezimalzeichen (.), Tausendertrennzeichen (,), Zeitzeichen (:), Datumszeichen (/) und Währungssymbole ($) zeigen diese Symbole standardmäßig entsprechend der Definition der Kultur der Anwendung an. Sie können sie erzwingen, Symbole für eine andere Kultur mithilfe der FormatProvider Eigenschaft anzuzeigen.
Die Zeicheneinfügung in die Maske zur Laufzeit wird durch die InsertKeyMode Eigenschaft gesteuert. Benutzer können mithilfe der NACH-LINKS- und NACH-RECHTS-TASTE oder mit dem Mauscursor durch die Maske navigieren und optionale Positionen im Maskenformat überspringen, indem Sie ein Leerzeichen eingeben.
Von Bedeutung
MaskedTextBox unterstützt alle Unicode-Zeichen mit Ausnahme von Ersatzzeichen und vertikal kombinierten Zeichen.
Die folgende Tabelle zeigt Beispielformate.
| Maske | 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 für die aktuelle Kultur der Anwendung geeignet ist. |
00->L<LL-0000 |
Ein Datum (Tag, Monatskürzel und Jahr) im US-amerikanischen Format, bei dem die dreibuchstabige Monatsabkürzung mit einem Anfangsbuchstaben in Großform gezeigt wird. Danach folgen 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. |
