定义和用法
CustomValidator 控件允许您书写处理输入值验证的方法。
属性
属性 | 描述 |
---|---|
BackColor | CustomValidator 控件的背景颜色。 |
ClientValidationFunction | 规定要被执行的客户端脚本函数的名称。 注释:脚本必须用浏览器支持的语言编写,比如 VBScript 或 JScript 使用 VBScript 时,函数必须位于表单内: Sub FunctionName (source, arguments) 使用 JScript 时,函数必须位于表单内: Function FunctionName (source, arguments) |
ControlToValidate | 要验证的控件的 id。 |
Display | 验证控件的显示行为。合法值有:
|
EnableClientScript | 布尔值,规定是否启用客户端验证。 |
Enabled | 布尔值,规定是否启用验证控件。 |
ErrorMessage | 当验证失败时,在 ValidationSummary 控件中显示的文本。 注释:如果未设置 Text 属性,文本也会显示在验证控件中。 |
ForeColor | 控件的前景色。 |
id | 控件的唯一 id。 |
IsValid | 布尔值,指示由 ControlToValidate 指定的控件是否通过验证。 |
OnServerValidate | 规定被执行的服务器端验证脚本函数的名称。 |
runat | 规定该控件是服务器控件。必须设置为 "server"。 |
Text | 当验证失败时显示的消息。 |
实例
CustomValidator
<script runat="server"> Sub user(source As object,args As ServerValidateEventArgs) if len(args.Value)<8 or len(args.Value)>16 then args.IsValid=false else args.IsValid=true end if End Sub </script> <!DOCTYPE HTML> <html> <body> <form runat="server"> <asp:Label runat="server" Text="Enter a username: " /> <asp:TextBox id="txt1" runat="server" /> <asp:Button Text="Submit" runat="server"/> <br> <asp:Label id="mess" runat="server"/> <br> <asp:CustomValidator ControlToValidate="txt1" OnServerValidate="user" Text="A username must be between 8 and 16 characters!" runat="server"/> </form> </body> </html>
在本例中,我们在 .aspx 文件中声明了两个 Label 控件,一个 TextBox 控件,一个 Button 控件,和一个 CustomValidator 控件。user() 函数可检测输入值的长度。如果长度小于 8 或大于 16,将在 CustomValidator 控件中显示文本 "A username must be between 8 and 16 characters!"。