MaskedTextBox.Mask MaskedTextBox.Mask MaskedTextBox.Mask MaskedTextBox.Mask Property

Definition

Ruft die zur Laufzeit zu verwendende Eingabemaske ab oder legt diese fest.Gets or sets the input mask to use at run time.

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

Eine String, die die aktuelle Maske darstellt.A String representing the current mask. Der Standardwert ist eine leere Zeichenfolge, die jede Eingabe ermöglicht.The default value is the empty string which allows any input.

Ausnahmen

Die an die Mask-Eigenschaft übergebene Zeichenfolge stellt keine gültige Maske dar.The string supplied to the Mask property is not a valid mask. Ungültige Masken schließen Masken ein, die nicht druckbare Zeichen enthalten.Invalid masks include masks containing non-printable characters.

Hinweise

Maskist die Standard Eigenschaft für die MaskedTextBox -Klasse.Mask is the default property for the MaskedTextBox class.

Maskmuss eine Zeichenfolge sein, die aus einem oder mehreren der Maskierungs Elemente besteht, wie in der folgenden Tabelle gezeigt.Mask must be a string composed of one or more of the masking elements, as shown in the following table. Die von MaskedTextBox verwendete Maskierungs Sprache wird durch MaskedTextProviderdie zugeordnete definiert.The masking language used by MaskedTextBox is defined by its associated MaskedTextProvider. Der Standardanbieter gibt eine Maskierungs Sprache auf der Grundlage derjenigen an, die das maskierte Bearbeitungs Steuerelement in Visual Basic 6,0 verwendet, und sollte den Benutzern, die von dieser Plattform migrieren, sehr vertraut sein.The standard provider specifies a masking language based upon the one used by the Masked Edit control in Visual Basic 6.0, and should be very familiar to users migrating from that platform.

Maskierungs ElementMasking element BeschreibungDescription
00 Ziffer, erforderlich.Digit, required. Dieses Element akzeptiert eine beliebige einzelne Ziffer zwischen 0 und 9.This element will accept any single digit between 0 and 9.
99 Ziffern oder Leerzeichen, optional.Digit or space, optional.
# Ziffern oder Leerzeichen, optional.Digit or space, optional. Wenn diese Position in der Maske leer ist, wird Sie als Leerzeichen in der Text -Eigenschaft gerendert.If this position is blank in the mask, it will be rendered as a space in the Text property. Plus Zeichen (+) und Minuszeichen (-) sind zulässig.Plus (+) and minus (-) signs are allowed.
LL Buchstabe, erforderlich.Letter, required. Schränkt die Eingabe auf die ASCII-Buchstaben a-z und a-z ein.Restricts input to the ASCII letters a-z and A-Z. Dieses Masken Element entspricht [a-zA-Z] in regulären Ausdrücken.This mask element is equivalent to [a-zA-Z] in regular expressions.
?? Buchstabe, optional.Letter, optional. Schränkt die Eingabe auf die ASCII-Buchstaben a-z und a-z ein.Restricts input to the ASCII letters a-z and A-Z. Dieses Masken Element entspricht [a-zA-Z]?This mask element is equivalent to [a-zA-Z]? in regulären Ausdrücken.in regular expressions.
& Zeichen, erforderlich.Character, required. Wenn die AsciiOnly Eigenschaft auf true festgelegt ist, verhält sich dieses Element wie das L-Element.If the AsciiOnly property is set to true, this element behaves like the "L" element.
CC Zeichen, optional.Character, optional. Ein beliebiges nicht-Steuerzeichen.Any non-control character. Wenn die AsciiOnly -Eigenschaft auf truefestgelegt ist, verhält sich dieses Element wie das "?"-Element.If the AsciiOnly property is set to true, this element behaves like the "?" element.
AA Alphanumerisch, erforderlich.Alphanumeric, required. Wenn die AsciiOnly -Eigenschaft auf truefestgelegt ist, sind die einzigen Zeichen, die Sie akzeptieren, die ASCII-Buchstaben a-z und a-z.If the AsciiOnly property is set to true, the only characters it will accept are the ASCII letters a-z and A-Z. Dieses Masken Element verhält sich wie das "a"-Element.This mask element behaves like the "a" element.
einea Alphanumerisch, optional.Alphanumeric, optional. Wenn die AsciiOnly -Eigenschaft auf truefestgelegt ist, sind die einzigen Zeichen, die Sie akzeptieren, die ASCII-Buchstaben a-z und a-z.If the AsciiOnly property is set to true, the only characters it will accept are the ASCII letters a-z and A-Z. Dieses Masken Element verhält sich wie das "A"-Element.This mask element behaves like the "A" element.
sein.. Dezimal Platzhalter.Decimal placeholder. Das tatsächliche Anzeige Zeichen ist das für den Format Anbieter geeignete Dezimalzeichen, das von der- FormatProvider Eigenschaft des Steuer Elements bestimmt wird.The actual display character used will be the decimal symbol appropriate to the format provider, as determined by the control's FormatProvider property.
,, Tausender Platzhalter.Thousands placeholder. Das tatsächliche Anzeige Zeichen ist der für den Format Anbieter geeignete Tausender Platzhalter, der durch die- FormatProvider Eigenschaft des Steuer Elements bestimmt wird.The actual display character used will be the thousands placeholder appropriate to the format provider, as determined by the control's FormatProvider property.
:: Zeit Trennzeichen.Time separator. Das tatsächliche Anzeige Zeichen ist das für den Format Anbieter geeignete Zeit Symbol, das von der- FormatProvider Eigenschaft des Steuer Elements bestimmt wird.The actual display character used will be the time symbol appropriate to the format provider, as determined by the control's FormatProvider property.
/ Datums Trennzeichen.Date separator. Das tatsächliche Anzeige Zeichen ist das für den Format Anbieter geeignete Datums Symbol, das von der- FormatProvider Eigenschaft des Steuer Elements bestimmt wird.The actual display character used will be the date symbol appropriate to the format provider, as determined by the control's FormatProvider property.
$ Währungssymbol.Currency symbol. Das tatsächlich angezeigte Zeichen ist das Währungssymbol, das für den Format Anbieter geeignet ist, wie durch die FormatProvider -Eigenschaft des-Steuer Elements festgelegt.The actual character displayed will be the currency symbol appropriate to the format provider, as determined by the control's FormatProvider property.
< Nach unten verschieben.Shift down. Konvertiert alle Zeichen, die Folgen, in Kleinbuchstaben.Converts all characters that follow to lowercase.
> Nach oben verschieben.Shift up. Konvertiert alle Zeichen, die Folgen, in Großbuchstaben.Converts all characters that follow to uppercase.
|| Deaktivieren Sie eine vorherige Verschiebung nach oben oder nach unten.Disable a previous shift up or shift down.
\\ Weg.Escape. Schützt ein Masken Zeichen und verwandelt es in ein Literalzeichen.Escapes a mask character, turning it into a literal. \"\" ist die Escapesequenz für einen umgekehrten Schrägstrich."\\" is the escape sequence for a backslash.
Alle anderen ZeichenAll other characters Literale.Literals. Alle nicht Masken Elemente werden innerhalb von MaskedTextBoxals sich selbst angezeigt.All non-mask elements will appear as themselves within MaskedTextBox. Literale belegen zur Laufzeit immer eine statische Position in der Maske und können vom Benutzer nicht verschoben oder gelöscht werden.Literals always occupy a static position in the mask at run time, and cannot be moved or deleted by the user.

Wenn Sie eine Maske ändern, MaskedTextBox wenn bereits eine Benutzereingabe enthält, die von einer MaskedTextBox vorherigen Maske gefiltert wurde, wird von versucht, diese Eingabe in die neue Masken Definition zu migrieren.If you change a mask when MaskedTextBox already contains user input filtered by a previous mask, MaskedTextBox will attempt to migrate that input into the new mask definition. Wenn ein Fehler auftritt, wird die vorhandene Eingabe gelöscht.If it fails, it will clear the existing input. Wenn Sie eine Zeichenfolge der Länge 0 (null) als Maske zuweisen, werden alle vorhandenen Daten im-Steuerelement beibehalten.Assigning a zero-length string as the mask will preserve any existing data in the control. Wenn Sie mit einer Maske der Länge 0 ( MaskedTextBox null) verwendet wird, verhält TextBox sich wie ein einzeilige Steuerelement.When used with a zero-length mask, MaskedTextBox behaves like a single-line TextBox control.

Die Symbole Decimal (.), Tausendstel (,), time (:), Date (/) und Currency ($) werden standardmäßig so angezeigt, wie Sie in der Kultur der Anwendung definiert sind.The decimal (.), thousandths (,), time (:), date (/), and currency ($) symbols default to displaying those symbols as defined by the application's culture. Mithilfe der FormatProvider -Eigenschaft können Sie erzwingen, dass Symbole für eine andere Kultur angezeigt werden.You can force them to display symbols for another culture by using the FormatProvider property.

Die Zeichen Einfügung in die Maske zur Laufzeit wird von der InsertKeyMode -Eigenschaft gesteuert.Character insertion into the mask at run time is controlled by the InsertKeyMode property. Benutzer können mithilfe der nach-links-und nach-rechts-Taste oder des Mauszeigers durch die Maske navigieren und optionale Positionen in der Maske überspringen, indem Sie ein Leerzeichen eingeben.Users can navigate through the mask by using the left and right arrow keys or the mouse cursor, and can skip optional positions in the mask by entering a space.

Wichtig

MaskedTextBoxunterstützt alle Unicode-Zeichen mit Ausnahme von Surrogates und vertikal kombinierten Zeichen.MaskedTextBox supports all Unicode characters except for surrogates and vertically combined characters.

In der folgenden Tabelle sind Beispiel Masken aufgeführt.The following table shows example masks.

FormatMask VerhaltenBehavior
00/00/0000 Ein Datum (Tag, numerischer Monat, Jahr) im internationalen Datumsformat.A date (day, numeric month, year) in international date format. Das Zeichen "/" ist ein logisches Datums Trennzeichen und wird dem Benutzer als Datums Trennzeichen angezeigt, das der aktuellen Kultur der Anwendung entspricht.The "/" character is a logical date separator, and will appear to the user as the date separator appropriate to the application's current culture.
00->L<LL-0000 Ein Datum (Tag, Monats Abkürzung und Jahr) in USA Format, in dem die drei buchstabige Monats Abkürzung mit einem ersten Großbuchstaben, gefolgt von zwei Kleinbuchstaben, angezeigt wird.A date (day, month abbreviation, and year) in United States format in which the three-letter month abbreviation is displayed with an initial uppercase letter followed by two lowercase letters.
(999)-000-0000 USA Telefonnummer, flächencode optional.United States phone number, area code 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.If users do not want to enter the optional characters, they can either enter spaces or place the mouse pointer directly at the position in the mask represented by the first 0.
$999,999.00 Ein Währungswert im Bereich von 0 bis 999999.A currency value in the range of 0 to 999999. Die Währungs-, Tausendstel-und Dezimalzeichen werden zur Laufzeit durch ihre kulturspezifischen Entsprechungen ersetzt.The currency, thousandth, and decimal characters will be replaced at run time with their culture-specific equivalents.

Gilt für:

Siehe auch