ASP.NET/Validate控件

维基教科书,自由的教学读本

共通的属性[编辑]

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

RequiredFieldValidator[编辑]

用于使被验证控件成为一个必需(必填)的字段。通过该控件,如果输入值的初始值未改变,则验证失败。默认情况下,初始值是空字符串 ("")。InitialValue 属性不为输入控件设置默认值,它指示了您不希望用户在输入控件中输入的值。

注释:输入值的开头和结尾的空格将在验证前被移除。

RegularExpressionValidator[编辑]

ValidationExpression属性写入正则表达式。

RangeValidator[编辑]

  • MaximumValue
  • MinimumValue
  • Type: 空间输入值的类型可以为String、Integer、Date、Double、Currency。

注释:如果输入控件为空,验证不会失败。请使用 RequiredFieldValidator 控件,使字段必需(必填)。

注释:如果输入值无法转换为指定的数据类型,验证不会失败。请使用 CompareValidator 控件,将其 Operator 属性设置为 ValidationCompareOperator.DataTypeCheck,这样就可以校验输入值的数据类型了。

CompareValidator[编辑]

  • Operator 要执行的比较操作的类型。运算符有:Equal、GreaterThan、GreaterThanEqual、LessThan、LessThanEqual、NotEqual、DataTypeCheck
  • Type: 空间输入值的类型可以为String、Integer、Date、Double、Currency。
  • ControlToCompare 要与所验证的控件进行比较的控件名称。
  • ValueToCompare 一个常数值,该值要与由用户输入到所验证的输入控件中的值进行比较。

注释:如果输入控件为空,则不会调用任何验证函数,并且验证将成功。使用 RequiredFieldValidator 控件使字段必需(必填)。

CustomValidator[编辑]

  • ClientValidationFunction 规定要被执行的客户端脚本函数的名称。
  • EnableClientScript 布尔值,规定是否启用客户端验证
  • OnServerValidate 规定被执行的服务器端验证脚本函数的名称。
  • ValidateEmptyText

如果验证函数在server端运行,需要做一些设定:

  1. 控件的ValidateEmptyText="True",这样被验证控件为空时才可能会被验证。
  2. 当所有前端验证控件通过之后,才会执行server端的定制验证。
  3. 在button的处理函数中执行 Page.Validate("ValidationGroupName"); if (!Page.IsValid) return; 其中,ValidationGroupName是一个字符串值,出现在各控件、验证控件的ValidationGroup="ValidationGroupName" 属性-值对中。因为在较新版本的.NET中,定制验证控件的验证函数必须通过Page.Validate函数才能在服务器端被执行。

ValidationSummary[编辑]

在该控件中显示的错误消息是由每个验证控件的 ErrorMessage 属性规定的。如果未设置验证控件的 ErrorMessage 属性,就不会为那个验证控件显示错误消息。

  • DisplayMode 如何显示摘要。合法值有:BulletList、List、SingleParagraph
  • HeaderText ValidationSummary 控件中的标题文本。
  • ShowMessageBox 布尔值,规定是否在消息框中显示验证摘要。
  • ShowSummary 布尔值,规定 ValidationSummary 控件是否显示或者隐藏。