maskedTextbox
命名空间:System.Windows.Forms
程序集:System.Windows.Forms（在 system.windows.forms.dll 中）
语法
| Visual Basic（声明） |
|---|
|
<LocalizableAttribute(True)> _Public Property Mask As String |
| Visual Basic（用法） |
|---|
|
Dim instance As MaskedTextBoxDim value As Stringvalue = instance.Maskinstance.Mask = value |
| C# |
|---|
|
[LocalizableAttribute(true)] public string Mask { get; set; } |
| C++ |
|---|
|
[LocalizableAttribute(true)] public:property String^ Mask { String^ get (); void set (String^ value);} |
| J# |
|---|
|
/** @property */public String get_Mask ()/** @property */public void set_Mask (String value) |
| JScript |
|---|
|
public function get Mask () : Stringpublic function set Mask (value : String) |
属性值
一个 String，表示当前掩码。默认值是允许任何输入的空字符串。
异常
| 异常类型 | 条件 |
|---|---|
|
ArgumentException |
提供给 Mask 属性的字符串不是一个有效掩码。无效掩码包括含不可打印字符的掩码。 |
备注
Mask 是 MaskedTextBox 类的默认属性。
Mask 必须是由一个或多个掩码元素组成的字符串，如下表所示。MaskedTextBox 使用的掩码语言由其关联的 MaskedTextProvider 进行定义。标准提供程序根据 Visual Basic 6.0 中 Masked Edit 控件使用的语言来指定掩码语言，从该平台迁移来的用户应该对它很熟悉。
|
掩码元素 |
说明 |
|---|---|
|
0 |
数字，必选。此元素将接受 0 到 9 之间的任何一个数字。 |
|
9 |
数字或空间，可选。 |
|
# |
数字或空间，可选。如果掩码中该位置为空白，在 Text 属性中将把它呈现为一个空格。允许使用加号 (+) 和减号 (-)。 |
|
L |
字母，必选。将输入限定为 ASCII 字母 a-z 和 A-Z。此掩码元素等效于正则表达式中的 [a-zA-Z]。 |
|
? |
字母，可选。输入限定为 ASCII 字母 a-z 和 A-Z。此掩码元素等效于正则表达式中的 [a-zA-Z]?。 |
|
& |
字符，必选。如果 AsciiOnly 属性设置为 true，此元素的行为将与“L”元素类似。 |
|
C |
字符，可选。任何非控制字符。如果 AsciiOnly 属性设置为 true，此元素的行为将类似于“?”元素。 |
|
A |
字母数字，可选。如果将 AsciiOnly 属性设置为 true，则它接受的唯一字符是 ASCII 字母 a-z 和 A-Z。 |
|
a |
字母数字，可选。如果将 AsciiOnly 属性设置为 true，则它接受的唯一字符是 ASCII 字母 a-z 和 A-Z。 |
|
. |
小数点占位符。使用的实际显示字符将是相应于格式提供程序的小数点占位符，格式提供程序由控件的 FormatProvider 属性决定。 |
|
, |
千分位占位符。使用的实际显示字符将是相应于格式提供程序的千分位占位符，格式提供程序由控件的 FormatProvider 属性决定。 |
|
: |
时间分隔符。使用的实际显示字符将是相应于格式提供程序的时间占位符，格式提供程序由控件的 FormatProvider 属性决定。 |
|
/ |
日期分隔符。使用的实际显示字符将是相应于格式提供程序的日期占位符，格式提供程序由控件的 FormatProvider 属性决定。 |
|
$ |
货币符号。显示的实际字符将是相应于格式提供程序的货币符号，格式提供程序由控件的 FormatProvider 属性决定。 |
|
< |
转换为小写。将后续所有字符都转换为小写。 |
|
> |
转换为大写。将后续所有字符都转换为大写。 |
|
| |
禁用前一个大写转换或小写转换。 |
|
\ |
转义。对掩码字符进行转义，将其转变为原义字符。“\\”是反斜杠的转义序列。 |
|
其他所有字符 |
原义字符。所有非掩码元素都将原样出现在 MaskedTextBox 中。原义字符在运行时始终占据掩码中的一个固定位置，用户不能移动或删除该字符。 |
如果您在 MaskedTextBox 已包含前一个掩码筛选过的用户输入时更改掩码，MaskedTextBox 会尝试将该输入迁移至新的掩码定义。如果失败，将清除现有的输入。为掩码赋予一个零长度的字符串会保留控件中现有的任何数据。当与零长度掩码一起使用时，MaskedTextBox 的行为与单行 TextBox 控件的类似。
小数点 (.)、千分位 (,)、时间 (:)、日期 (/) 和货币 ($) 符号默认为按照应用程序的区域性的定义显示这些符号。可以通过使用 FormatProvider 属性强制这些符号显示为其他区域性的符号。
运行时掩码中的字符插入由 InsertKeyMode 属性控制。用户可以通过使用左箭头和右箭头或鼠标指针在掩码中移动，或者可以通过输入空格跳过掩码中的可选位置。
 重要事项： |
|---|
|
MaskedTextBox 支持除代理项和纵向组合字符以外的所有 Unicode 字符。 |
下表显示了示例掩码。
|
掩码 |
行为 |
|---|---|
|
00/00/0000 |
采用国际日期格式的日期（日、数字月份、年份）。“/”字符是逻辑日期分隔符，将以相应于应用程序当前区域性的日期分隔符形式显示给用户。 |
|
00->L<LL-0000 |
美国格式的日期（天、月缩写和年），其中月份用缩写的三个字母表示，第一个字母大写并且其余两个字母小写。 |
|
(999)-000-0000 |
美国电话号码（区号可选）。如果用户不想输入可选字符，他们可以输入空格或将鼠标指针直接放在掩码中第一个 0 表示的位置。 |
|
$999,999.00 |
货币值的范围从 0 到 999999。货币、千位和十进制字符在运行时会被替换为区域特定的等效内容。 |
