maskedTextbox

来源：互联网发布：南京大汉网络职位编辑：程序博客网时间：2024/06/03 23:54

命名空间:System.Windows.Forms

程序集:System.Windows.Forms（在 system.windows.forms.dll 中）

Mask 是 MaskedTextBox 类的默认属性。

Mask 必须是由一个或多个掩码元素组成的字符串，如下表所示。MaskedTextBox 使用的掩码语言由其关联的 MaskedTextProvider 进行定义。

掩码元素

说明

数字，必选。此元素将接受 0 到 9 之间的任何一个数字。

数字或空间，可选。

数字或空间，可选。如果掩码中该位置为空白，在 Text 属性中将把它呈现为一个空格。允许使用加号 (+) 和减号 (-)。

字母，必选。将输入限定为 ASCII 字母 a-z 和 A-Z。此掩码元素等效于正则表达式中的 [a-zA-Z]。

字母，可选。输入限定为 ASCII 字母 a-z 和 A-Z。此掩码元素等效于正则表达式中的 [a-zA-Z]?。

字符，必选。如果 AsciiOnly 属性设置为 true，此元素的行为将与“L”元素类似。

字符，可选。任何非控制字符。如果 AsciiOnly 属性设置为 true，此元素的行为将类似于“?”元素。

字母数字，可选。如果将 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。货币、千位和十进制字符在运行时会被替换为区域特定的等效内容。