maskedTextbox

maskedTextbox

默认分类    2007-12-04 17:08   阅读69   评论0  

字号： 大 大  中 中  小 小

命名空间: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。货币、千位和十进制字符在运行时会被替换为区域特定的等效内容。

转载于:https://www.cnblogs.com/kuwoyidai/archive/2009/09/30/1577083.html