ajax控件之MaskedEdit - hebingbing的博客

作者在 2008-05-03 23:05:54 发布以下内容

//这个控件应该是两个控件的组合
控件名：MaskedEditValidator 验证用户输入的内容是否满足指定的内容和格式。
ModalPopupExtender 控制用户输入的字符和内容格式
用途及效果;为textbox等的控件设置固定的格式和输入的限制。

1.MaskedEditExtender 的属性和说明

^属^性	^说^明
^{TargetControlID}	^{使用该控件的}^ASP.NET^{服务器端控件的}^ID^值
^MaskType	^{屏蔽的类型}
^Mask	^{指定接收的字符和格式}
^AcceptAMPM	^{是否接受“}^AM/PM^{”字符串。默认值为}^false
^{AcceptNegative}	^{是否接受负号（}^-^{）。其值可以是}^None^、^Left^或^Right
^AutoComplete	^{是否使用自动完成功能}
^{AutoCompleteValue}	^{自动完成时使用的值}
^{ClearTextOnInvalid}	^{当内容不合法时，是否自动清空文本}
^{ClipboardEnabled}	^{是否允许粘贴或拷贝}
^{ErrorTooltipEnabled}	^{是否使用错误提示功能}

^Century	^{默认的世纪}
^{ClearMaskOnLostFocus}	^当^TextBox^{控件失去焦点时，是否清空屏蔽字符}
^{ClipboardText}	^{剪切板的文本}
^DisplayMoney	^{货币符号显示方式}
^Filtered	^{合法字符集合}
^{InputDirection}	^{输入文本的方向}
^{MessageValidatorTip}	^{当用户输入内容时，显示的提示文本}
^{PromptChararacter}	^{提示字符集合}
^CultureName	^文化名称
^{ErrorTooltipCssClass}	^{错误提示文本的样式}
^{OnFocusCssClass}	^{当焦点落在}^TextBox^{控件上时，}^TextBox^{控件的样式}
^{OnInvalidCssClass}	^{当内容不合法时，}^TextBox^{控件的样式}
^{OnFocusCssNegative}	^{当焦点落在}^TextBox^{控件且内容为负值时，}^TextBox^{控件的样式}
^{OnBlurCssNegative}	^当^TextBox^{控件失去焦点且内容为负值时，}^TextBox^{控件的样式}
^{UserDateFormat}	^日期格式
^{UserTimeFormat}	^时间格式
^{CultureDateFormat}	^{本地化日期格式}
^{CultureAMPMPlaceholder}	^{与当前页的文化相关}
^{CultureCurrencySymbolPlaceholder}	^{与当前页的文化相关}
^{CultureDatePlaceholder}	^{与当前页的文化相关}
^{CultureDecimalPlaceholder}	^{与当前页的文化相关}
^{CultureThousandsPlaceholder}	^{与当前页的文化相关}
^{CultureTimePlaceholder}	^{与当前页的文化相关}

MaskType属性指定屏蔽的类型，即验证的类型。它的值可以是以下5个值：

— None，未指定验证类型。

— Number，数字验证类型。

— Date，日期验证类型。

— Time，时间验证类型。

— DateTime，日期和时间验证类型。

Mask属性指定接收的字符和格式，它的值是一个字符串，如表示日期的“9999-99-99”（年份为4位的数字，月份和日期都为2位的数字，分隔符号为“-”）、表示时间的“99:99:99”等。在 Mask属性中，它可以使用通配符表示一类字符，具体说明如表2.9所示。

表2.9 Mask中的通配符及其说明

^通^配^符	^说^明
⁹	^{表示数字（}^0~9^）
^L	^{表示一个字母，可以大写或小写}
^$	^{表示一个字母或空格}

续表

^通^配^符	^说^明
^C	^{表示一个自定义字符}
^A	^{表示一个字母或一个自定义字符}
^N	^{表示一个数字或一个自定义字符}
^?	^{表示任意一个字符}

在Mask属性中，除了使用通配符之外，还可以使用分隔符，具体说明如表2.10所示。

表2.10 Mask中的分隔符及其说明

^通^配^符	^说^明
^/	^{日期分隔符}
^:	^{时间分隔符}
^.	^小数点
^,	^{千位分隔符}
^\	^转义字符
^{	^{重复值的开始部分}
^}	^{重复值的结束部分}

使用表2.9中的通配符和表2.10中的分隔符可以组成多种多样的格式字符串，常用的实例如下：

—“99:99:99”，表示时间字符串。

—“9999-99-99”，表示日期字符串。

—“999999”，表示由6个数字组成的字符串。

—“9\/9”，表示由2个数字组成的中间被字符“/”分隔的字符串。

DisplayMoney属性能够指定显示货币符号（如￥、$等）的方式，具体描述如下：

— None，不显示货币符号。

— Left，在最左边显示货币符号。

— Right，在最右边显示货币符号。

AcceptNegative属性指定能否接受负号（-），具体描述如下：

— None，不显示负号。

— Left，在最左边显示负号。

— Right，在最右边显示负号。

InputDirection 属性指定文本的方向，它的值可以为LeftToRight（表示从左到右）和RightToLeft（表示从右到左）。在下述实例代码中， MaskedEditExtender控件指定验证类型为日期类型（由MaskType属性指定），格式字符串为“9999-99-99”。因此，用户只能输入日期格式的数据。

2.MaskedEditValidator的属性和说明;

^属^性	^说^明
^{ControlToValidate}	^{被验证控件的}^ID^属性的值
^{ControlExtender}	^{与其相对应的}^{MaskedEditExtender}^{控件指定的}^TextBox^控件的^ID^属性的值
^AcceptAMPM	^{是否接受“}^AM/PM^{”字符串。默认值为}^false
^InitialValue	^{与其相对应的}^TextBox^{控件的初始值}
^IsValidEmpty	^{与其相对应的}^TextBox^{控件的值为空是否合法}
^MaximumValue	^最大值
^MinimumValue	^最小值
^{ValidationExpression}	^{验证内容的正则表达式}
^{ClientValidationFunction}	^{客户端验证函数的名称}
^{TooltipMessage}	^TextBox^{控件具有焦点时显示的消息}
^{EmptyValueMessage}	^TextBox^{控件具有焦点，该控件的内容为空时显示的消息}
^{EmptyValueBlurredText}	^TextBox^{控件不具有焦点，该控件的内容为空时显示的消息}
^{InvalidValueMessage}	^TextBox^{控件具有焦点，验证不合法时显示的消息}
^{InvalidValueBlurredMessage}	^TextBox^{控件不具有焦点，验证不合法时显示的消息}
^{MaximumValueMessage}	^TextBox^{控件具有焦点，控件的内容超过最大值时显示的消息}
^{MaximumValueBlurredMessage}	^TextBox^{控件不具有焦点，控件的内容超过最大值时显示的消息}
^{MinimumValueMessage}	^TextBox^{控件具有焦点，控件的内容超过最小值时显示的消息}
^{MinimumValueBlurredText}	^TextBox^{控件不具有焦点，控件的内容超过最小值时显示的消息}

————————————————————

编程少年基地

http://www.bcsnjd.cn

提供代码测试、视频培训等功能