ASP.NET 验证控件
一、RequiredFieldValidator
说明:使关联的输入控件成为一个必选字段。
功能RequiredFieldValidator控件,常用于验证文本输入框是否为空。当用户提交网页中的数据到服务器端时,系统自动检查被验证控件的输入内容是否为空,如果为空,则RequiredFieldValidator控件在网页中显示提示信息。
示例:
<asp:RequiredFieldValidator ID="RequiredFieldValidator1" runat="server" ControlToValidate="txtName" ErrorMessage="请输入姓名!"></asp:RequiredFieldValidator>
属性 |
描述 |
ControlToValidate |
该属性获取或设置要验证的输入控件 |
Display |
该属性获取或设置验证控件中错误信息的显示行为 |
EnableViewState |
该属性获取或设置一个值,该值指示服务器控件是否向发出请求的客户端保持自己的视图状态以及它所包含的任何子控件的视图状态 |
ErrorMessage |
该属性获取或设置验证失败时ValidationSummary控件中显示的错误信息的文本 |
ForeColor |
该属性获取或设置验证失败后显示的消息的颜色 |
IsValid |
该属性获取或设置一个值,该值指示关联的输入控件是否通过验证 |
SetFocusOnError |
该属性获取或设置一个值,该值指示在验证失败时是否将焦点设置到ControlToValidate属性指定的控件上 |
Text |
该属性获取或设置验证失败时验证控件中显示的文本 |
Page |
该属性获取对包含服务器控件的 Page实例的引用 |
Visible |
该属性获取或设置一个值,该值指示服务器控件是否作为 UI呈现在页上 |
二、CompareValidator
说明:将用户输入控件的值与输入到其他空间的值或常熟值进行比较
CompareValidator 控件又称为“比较验证控件”,它主要用于将输入控件的值与指定的常数值或其他输入控件的值按照指定的比较运算符(>、<、=、<>、>=及<=等)进行比较,以判断两个值是否匹配。此外,CompareValidator 控件还可以用来判断用户输入的值是否可以转换为其Type属性所指定的数据类型。
示例:
<asp:CompareValidator ID="CompareValidator1" runat="server" ControlToCompare="txtA" ControlToValidate="txtB" ErrorMessage="值需大于B值"></asp:CompareValidator>
属性 | 描述 |
BackColor | CompareValidator 控件的背景颜色。 |
ControlToCompare | 要与所验证的输入控件进行比较的输入控件。 |
ControlToValidate | 要验证的输入控件的 ID。 |
Display |
验证控件中错误信息的显示行为。 合法值是:
|
EnableClientScript | 布尔值,规定是否启用客户端验证。 |
Enabled | 布尔值,规定是否启用验证控件。 |
ErrorMessage |
当验证失败时在 ValidationSummary 控件中显示的文本。 注释:如果未设置 Text 属性,此文本将显示在验证控件中。 |
ForeColor | 控件的前景颜色。 |
id | 控件的唯一 ID。 |
IsValid | 布尔值,指示由 ControlToValidate 指定的输入控件是否通过验证。 |
Operator |
要执行的比较操作的类型。 运算符是:
|
runat | 规定控件是服务器控件。必须设置为 "server"。 |
Text | 当验证失败时显示的消息。 |
Type |
规定要对比的值的数据类型。 类型有:
|
ValueToCompare | 一个常数值,该值要与由用户输入到所验证的输入控件中的值进行比较。 |
三、RangeValidator
说明:检查输入控件的值是否在指定范围内
示例:
<asp:RangeValidator ID="RangeValidator3" runat="server" ControlToValidate="txtAge" ErrorMessage="RangeValidator" MaximumValue="60" MinimumValue="18"></asp:RangeValidator>
属性 | 描述 |
---|---|
BackColor | RangeValidator 控件的背景颜色 |
ControlToValidate | 要验证的控件的 id |
Display | 验证控件的显示行为。
合法的值有:
|
EnableClientScript | 布尔值,规定是否启用客户端验证。 |
Enabled | 布尔值,规定是否启用验证控件。 |
ErrorMessage |
当验证失败时,在 ValidationSummary 控件中显示的文本。 注释:如果未设置 Text 属性,文本也会显示在该验证控件中。 |
ForeColor | 该控件的前景色。 |
id | 控件的唯一 id。 |
IsValid | 布尔值,指示关联的输入控件是否通过验证。 |
MaximumValue | 规定输入控件的最大值。 |
MinimumValue | 规定输入控件的最小值。 |
runat | 规定该控件是一个服务器控件。必须设置为 "server"。 |
Type |
规定要检测的值的数据类型。类型有:
|
Text | 当验证失败时显示的消息。 |
四、RegularExpressionValidator
说明:用于验证输入值是否匹配正则表达式指定的模式。
示例:
<asp:RegularExpressionValidator ID="RegularExpressionValidator1" runat="server" ControlToValidate="txtEmail" ErrorMessage="邮箱格式不正确" ValidationExpression="\w+([-+.']\w+)*@\w+([-.]\w+)*\.\w+([-.]\w+)*"></asp:RegularExpressionValidator>
属性 | 描述 |
---|---|
BackColor | RangeValidator 控件的背景颜色 |
ControlToValidate | 要验证的控件的 id |
Display | 验证控件的显示行为。
合法的值有:
|
EnableClientScript | 布尔值,规定是否启用客户端验证。 |
Enabled | 布尔值,规定是否启用验证控件。 |
ErrorMessage |
当验证失败时,在 ValidationSummary 控件中显示的文本。 注释:如果未设置 Text 属性,文本也会显示在该验证控件中。 |
ForeColor | 该控件的前景色。 |
id | 控件的唯一 id。 |
IsValid | 布尔值,指示关联的输入控件是否通过验证。 |
runat | 规定该控件是一个服务器控件。必须设置为 "server"。 |
Text | 当验证失败时显示的消息。 |
ValidationExpression | 规定验证输入控件的正则表达式。在客户端和服务器上,表达式的语法是不同的。 |
五、CustomValidator
说明:可对输入控件执行用户定义的验证。
示例:
<head id="head" runat="server"> <title>CustomValidator </title> <script language="javascript" type="test" > function valNum(oSrc,args) { args.IsValid =(args.Value % 5==0); } </script> </head> <body> <asp:TextBox ID="txtNum" runat="server"></asp:TextBox> <asp:CustomValidator ID="CustomValidator1" runat="server" ClientValidationFunction="valNum" ControlToValidate="txtPrice" ErrorMessage="数字不能被5整除"></asp:CustomValidator> </body>
六、ValidationSummary
说明:用于在网页、消息框或在这两者中内联显示所有验证错误的摘要。
示例:
<asp:ValidationSummary ID="ValidationSummary1" runat="server" HeaderText="发生了以下错误:" />
属性 | 描述 |
---|---|
DisplayMode |
如何显示摘要。合法值有:
|
EnableClientScript | 布尔值,规定是否启用客户端验证。 |
Enabled | 布尔值,规定是否启用验证控件。 |
ForeColor | 该控件的前景色。 |
HeaderText | ValidationSummary 控件中的标题文本。 |
id | 控件的唯一 id。 |
runat | 规定该控件是一个服务器控件。必须设置为 "server"。 |
ShowMessageBox | 布尔值,指示是否在消息框中显示验证摘要。 |
ShowSummary | 布尔值,规定是否显示验证摘要。 |