(From the MSDN on-line help.)
Masking Element |
Description |
---|---|
0 | Digit required. This element will accept any single digit between 0 and 9. |
9 | Digit or space, optional. |
# | Digit or space, optional. If this position is blank in the mask, it will be rendered as a space in the Text property. Plus (+) and minus (-) signs are allowed. |
L | Letter required. Restricts input to the ASCII letters a-z and A-Z.
This mask element is equivalent to [a-zA-Z] in regular expressions. |
? | Letter, optional. Restricts input to the ASCII letters a-z and A-Z.
This mask element is equivalent to [a-zA-Z]? in regular expressions. |
& | Character, required. If the AsciiOnly property is set to true,
this element behaves like the Lelement. |
C | Character, optional. Any non-control character.
If the AsciiOnly property is set to true, this element behaves like the ?element. |
A | Alphanumeric, optional. If the AsciiOnly property is set to true, the only characters it will accept are the ASCII letters a-z and A-Z. |
a | Alphanumeric, optional. If the AsciiOnly property is set to true, the only characters it will accept are the ASCII letters a-z and A-Z. |
. | (A period) Decimal placeholder. The actual display character used will be the decimal symbol appropriate to the format provider, as determined by the control's FormatProvider property. |
, | (A comma) Thousands placeholder. The actual display character used will be the thousands placeholder appropriate to the format provider, as determined by the control's FormatProvider property. |
: | Time separator. The actual display character used will be the time symbol appropriate to the format provider, as determined by the control's FormatProvider property. |
/ | Date separator. The actual display character used will be the date symbol appropriate to the format provider, as determined by the control's FormatProvider property. |
$ | Currency symbol. The actual character displayed will be the currency symbol appropriate to the format provider, as determined by the control's FormatProvider property. |
< | Shift down. Converts all characters that follow to lowercase. |
> | Shift up. Converts all characters that follow to uppercase. |
| | Disable a previous shift up or shift down. |
\ | Escape. Escapes a mask character, turning it into a literal.
\\is the escape sequence for a literal backslash. |
All Others |
Literals. All non-mask elements will appear as themselves within MaskedTextBox. Literals always occupy a static position in the mask at run time, and cannot be moved or deleted by the user. |
Example | Explanation |
---|---|
00/00/0000 |
A date (day, numeric month, year) in international date format.
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 |
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 |
United States phone number, area code optional. 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 |
A currency value in the range of 0 to 999999. The currency, thousandth, and decimal characters will be replaced at run time with their culture-specific equivalents. |
Note that using a mask only limits what characters can be
entered.
There is nothing in a mask that allows you to limit a (for example)
month number
to the range 1–12, or a value for
minutes
to the range 00–59.
So you still need to validate user input!