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

Definition

Übernimmt oder bestimmt das Eingabeformat für die Verwendung zur Laufzeit.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

Ein 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 Zeichenfolge angegeben wird, um die Mask Eigenschaft ist keine gültige Maske.The string supplied to the Mask property is not a valid mask. Ungültige Masken schließen Masken ein, die nicht druckbare Zeichen.Invalid masks include masks containing non-printable characters.

Hinweise

Mask ist die Standardeigenschaft für die MaskedTextBox Klasse.Mask is the default property for the MaskedTextBox class.

Mask eine Zeichenfolge muss wie in der folgenden Tabelle gezeigt eine oder mehrere Elemente der Maskierung zusammengesetzt werden.Mask must be a string composed of one or more of the masking elements, as shown in the following table. Von verwendete Maskierungssprache MaskedTextBox wird definiert durch den zugeordneten MaskedTextProvider.The masking language used by MaskedTextBox is defined by its associated MaskedTextProvider. Der Standardanbieter gibt eine Maskierungssprache basierend auf vom MaskedEdit-Steuerelement in Visual Basic 6.0 verwendet, und sollte für Benutzer, die von dieser Plattform migrieren 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.

Maskierung-elementMasking element BeschreibungDescription
00 Ziffer, erforderlich.Digit, required. Dieses Element akzeptiert eine 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 es als Leerzeichen in gerendert werden die Text Eigenschaft.If this position is blank in the mask, it will be rendered as a space in the Text property. Pluszeichen (+) und minus (-) Zeichen sind zulässig.Plus (+) and minus (-) signs are allowed.
LL Buchstabe, erforderlich.Letter, required. Schränkt die Eingabe für den ASCII-Buchstaben a-Z und A – Z.Restricts input to the ASCII letters a-z and A-Z. Dieses Maskenelement 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 für den ASCII-Buchstaben a-Z und A – Z.Restricts input to the ASCII letters a-z and A-Z. Dieses Maskenelement 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 -Eigenschaftensatz auf "true", dieses Element verhält sich, wie das Element "L".If the AsciiOnly property is set to true, this element behaves like the "L" element.
CC Zeichen, optional.Character, optional. Beliebiges Zeichen kein Steuerelement.Any non-control character. Wenn die AsciiOnly -Eigenschaftensatz auf true, dieses Element verhält sich 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 -Eigenschaftensatz auf true, er akzeptiert, nur die Zeichen sind, 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 Maskenelement verhält sich wie "a" das Element.This mask element behaves like the "a" element.
einea Alphanumerisch, optional.Alphanumeric, optional. Wenn die AsciiOnly -Eigenschaftensatz auf true, er akzeptiert, nur die Zeichen sind, 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 Maskenelement verhält sich wie "A" das Element.This mask element behaves like the "A" element.
sein.. Dezimalplatzhalter.Decimal placeholder. Das tatsächliche Anzeige verwendete Zeichen werden das Dezimalsymbol für den Formatanbieter, laut des Steuerelements FormatProvider Eigenschaft.The actual display character used will be the decimal symbol appropriate to the format provider, as determined by the control's FormatProvider property.
,, Tausende Platzhalter.Thousands placeholder. Das tatsächliche Anzeige verwendete Zeichen wird das Tausendertrennzeichen für den Formatanbieter, laut des Steuerelements geeignete Platzhalter FormatProvider Eigenschaft.The actual display character used will be the thousands placeholder appropriate to the format provider, as determined by the control's FormatProvider property.
:: Trennzeichen für Zeitangaben.Time separator. Das tatsächliche Anzeige verwendete Zeichen werden dem Time-Symbol, das für den Formatanbieter, laut des Steuerelements FormatProvider Eigenschaft.The actual display character used will be the time symbol appropriate to the format provider, as determined by the control's FormatProvider property.
/ Datumstrennzeichen.Date separator. Das tatsächliche Anzeige verwendete Zeichen werden das Datum-Symbol, das für den Formatanbieter, laut des Steuerelements FormatProvider Eigenschaft.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. Welches Zeichen tatsächliche angezeigt werden das Währungssymbol ein, die für den Formatanbieter, laut des Steuerelements FormatProvider Eigenschaft.The actual character displayed will be the currency symbol appropriate to the format provider, as determined by the control's FormatProvider property.
< Wechseln Sie nach unten.Shift down. Konvertiert alle Zeichen in Kleinbuchstaben.Converts all characters that follow to lowercase.
> Nach oben zu verschieben.Shift up. Konvertiert alle Zeichen, die in Großbuchstaben folgen.Converts all characters that follow to uppercase.
|| Deaktivieren Sie ein nach oben oder nach unten verschoben.Disable a previous shift up or shift down.
\\ Mit Escapezeichen versehen.Escape. Ein Zeichen zum Maskieren, wandelt sie in ein Literal mit Escapezeichen zu versehen.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-Maske Elemente werden angezeigt, als Sie selbst in MaskedTextBox.All non-mask elements will appear as themselves within MaskedTextBox. Literale können nicht immer eine statische Position in der Maske zur Laufzeit belegen und verschoben oder gelöscht werden durch den Benutzer.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 beim MaskedTextBox enthält bereits durch eine vorherige Maske, gefilterte Benutzereingabe MaskedTextBox wird versucht, diese Eingabe in die neue Maskendefinition 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 er die vorhandene Eingabe gelöscht.If it fails, it will clear the existing input. Eine Zeichenfolge der Länge 0 (null) als Maske zuweisen, behält alle vorhandenen Daten in das Steuerelement.Assigning a zero-length string as the mask will preserve any existing data in the control. Bei Verwendung mit einer Maske mit der Länge null MaskedTextBox verhält sich wie eine einzeilige TextBox Steuerelement.When used with a zero-length mask, MaskedTextBox behaves like a single-line TextBox control.

Das Dezimaltrennzeichen (.), Tausendstel-(,), Zeit (:), Datum (/) und Währung ($) werden standardmäßig diese Symbole angezeigt, wie die Kultur der Anwendung definiert.The decimal (.), thousandths (,), time (:), date (/), and currency ($) symbols default to displaying those symbols as defined by the application's culture. Sie können erzwingen, Anzeigen von einer anderen Kultur mithilfe der FormatProvider Eigenschaft.You can force them to display symbols for another culture by using the FormatProvider property.

Einfügen von Zeichen in der Maske zur Laufzeit wird gesteuert, indem die InsertKeyMode Eigenschaft.Character insertion into the mask at run time is controlled by the InsertKeyMode property. Benutzer können mithilfe von links und Pfeil nach rechts-Tasten oder den Cursor durch die Maske navigieren und können optionale Positionen in der Maske durch Drücken der LEERTASTE überspringen.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

MaskedTextBox unterstützt alle Unicode-Zeichen mit Ausnahme von Ersatzzeichen und vertikal kombinierte Zeichen.MaskedTextBox supports all Unicode characters except for surrogates and vertically combined characters.

Die folgende Tabelle zeigt Beispielmasken.The following table shows example masks.

FormatMask VerhaltenBehavior
00/00/0000 Ein Datum (Tag, Monat, Jahr) in internationalen Datumsformat.A date (day, numeric month, year) in international date format. Das Zeichen "/" ist ein logischer Datumstrennzeichen, und für den Benutzer als das Datumstrennzeichen zur aktuellen Kultur der Anwendung angezeigt.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, Abkürzung für den Monat und Jahr) in den USA-Format, in dem die drei Buchstaben bestehenden monatsabkürzung mit einem anfänglichen 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 Vereinigte Staaten Telefonnummer angeben, die Vorwahl ist optional.United States phone number, area code optional. Wenn der Benutzer nicht die optionalen Zeichen eingeben möchten, können sie entweder Geben Sie ein Leerzeichen oder platzieren Sie den Mauszeiger-auf direkt an der Position in der Maske, die durch die ersten 0 dargestellt.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ährung, Tausendstel und dezimale Zeichen werden zur Laufzeit durch die kulturspezifischen-äquivalente ersetzt werden.The currency, thousandth, and decimal characters will be replaced at run time with their culture-specific equivalents.

Gilt für:

Siehe auch