Contrôle CustomValidator ASP.NET

Définition et utilisation

Le contrôle CustomValidator du ASP.NET peut effectuer une validation définie par l'utilisateur sur les contrôles d'entrée.

Propriété

Propriété Description
BackColor Couleur de fond du contrôle CustomValidator.
ClientValidationFunction

Définir le nom de la fonction de script client personnalisé utilisée pour la validation.

Remarque : le script doit être écrit dans un langage pris en charge par le navigateur, par exemple VBScript ou JScript

Si vous utilisez VBScript, la fonction doit être située dans le formulaire :

Sub FunctionName (source, arguments)

Si vous utilisez JScript, la fonction doit être située dans le formulaire :

Function FunctionName (source, arguments)

ControlToValidate 要验证的输入控件的 id。
Display

验证控件中错误信息的显示行为。

合法的值有:

  • None - 验证消息从不内联显示。
  • Static - 在页面布局中分配用于显示验证消息的空间。
  • Dynamic - 如果验证失败,将用于显示验证消息的空间动态添加到页面。
EnableClientScript 布尔值,该值指示是否启用客户端验证。
Enabled 布尔值,该值指示是否启用验证控件。
ErrorMessage

验证失败时 ValidationSummary 控件中显示的错误信息的文本。

注释:如果设置了 ErrorMessage 属性但没有设置 Text 属性,则验证控件中也将显示 ErrorMessage 属性的值。

ForeColor 控件的前景色。
id 控件的唯一 id。
IsValid 布尔值,该值指示关联的输入控件是否通过验证。
OnServerValidate 规定将被执行的服务器端验证脚本函数的名称。
runat 规定该控件是服务器控件。必须设置为 "server"。
Text 验证失败时显示的文本。

实例

CustomValidator
在此示例中,我们在 .aspx 文件中声明了两个 Label 控件,一个 TextBox 控件,一个 Button 控件,以及一个 CustomValidator 控件。user() 函数可以检测输入值的长度。如果长度小于 8 或大于 16,将在 CustomValidator 控件中显示文本 "用户名必须介于 8 到 16 个字符之间!"。