ASP.NET CustomValidator 控件

up.gif Validation 服务器控件

定义和用法

CustomValidator 控件允许您书写处理输入值验证的方法。

属性

属性描述
BackColorCustomValidator 控件的背景颜色。
ClientValidationFunction规定要被执行的客户端脚本函数的名称。    注释：脚本必须用浏览器支持的语言编写，比如 VBScript 或 JScript

使用 VBScript 时，函数必须位于表单内：

Sub FunctionName (source, arguments)

使用 JScript 时，函数必须位于表单内：

Function FunctionName (source, arguments)

ControlToValidate要验证的控件的 id。
Display验证控件的显示行为。合法值有：
  • None - 控件不显示。仅用于 ValidationSummary 控件中显示错误消息。
  • Static - 如果验证失败，控件显示错误消息。即使输入通过验证，也在页面上预留显示消息的空间，即用于显示消息的空间是预先分配好的。
  • Dynamic - 如果验证失败，控件显示错误消息。如果输入通过验证，页面上不预留显示消息的空间，即用于显示消息的空间是动态添加的。
EnableClientScript布尔值，规定是否启用客户端验证。
Enabled布尔值，规定是否启用验证控件。
ErrorMessage当验证失败时，在 ValidationSummary 控件中显示的文本。    注释：如果未设置 Text 属性，文本也会显示在验证控件中。
ForeColor控件的前景色。
id控件的唯一 id。
IsValid布尔值，指示由 ControlToValidate 指定的控件是否通过验证。
OnServerValidate规定被执行的服务器端验证脚本函数的名称。
runat规定该控件是服务器控件。必须设置为 "server"。
Text当验证失败时显示的消息。

实例

CustomValidator
在本例中，我们在 .aspx 文件中声明了两个 Label 控件，一个 TextBox 控件，一个 Button 控件，和一个 CustomValidator 控件。user() 函数可检测输入值的长度。如果长度小于 8 或大于 16，将在 CustomValidator 控件中显示文本 "A username must be between 8 and 16 characters!"。

up.gif Validation 服务器控件