ASP.NET RangeValidator 控件

定义和用法

RangeValidator 控件用于检测用户输入的值是否介于两个值之间。可以对不同类型的值进行比较，比如数字、日期以及字符。

注释：如果输入控件为空，验证不会失败。请使用 RequiredFieldValidator 控件，使字段成为必选字段。

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

属性

属性 描述
BackColor RangeValidator 控件的背景颜色
ControlToValidate 要验证的控件的 id
Display 验证控件的显示行为。 合法的值有： - None - 验证消息从不内联显示。 - Static - 在页面布局中分配用于显示验证消息的空间。 - Dynamic - 如果验证失败，将用于显示验证消息的空间动态添加到页面。
EnableClientScript 布尔值，规定是否启用客户端验证。
Enabled 布尔值，规定是否启用验证控件。
ErrorMessage 当验证失败时，在 ValidationSummary 控件中显示的文本。 注释：如果未设置 Text 属性，文本也会显示在该验证控件中。
ForeColor 该控件的前景色。
id 控件的唯一 id。
IsValid 布尔值，指示关联的输入控件是否通过验证。
MaximumValue 规定输入控件的最大值。
MinimumValue 规定输入控件的最小值。
runat 规定该控件是一个服务器控件。必须设置为 "server"。
Type 规定要检测的值的数据类型。类型有： - Currency - Date - Double - Integer - String
Text 当验证失败时显示的消息。

实例

  • RangeValidator

    在本例中，我们在 .aspx 文件中声明了一个 TextBox 控件，一个 Button 控件，以及一个 RangeValidator 控件。如果验证失败，将在 RangeValidator 控件中显示文本 "The date must be between 1/1/2002 and 31/5/2002!"。 

  1. <html>
  2. <body>
  4. <form runat="server">
  5. 请输入介于 2005-01-01 到 2005-12-31 的日期：
  6. <br />
  7. <asp:TextBox id="tbox1" runat="server" />
  8. <br /><br />
  9. <asp:Button Text="验证" runat="server" />
  10. <br /><br />
  11. <asp:RangeValidator
  12. ControlToValidate="tbox1"
  13. MinimumValue="2005-01-01"
  14. MaximumValue="2005-12-31"
  15. Type="Date"
  16. EnableClientScript="false"
  17. Text="日期必须介于 2005-01-01 和 2005-12-31 之间！"
  18. runat="server" />
  19. </form>
  21. </body>
  22. </html>

  • RangeValidator 2

    在本例中，我们在 .aspx 文件中声明了一个 TextBox 控件，一个 Button 控件，一个 Label 控件，以及一个 RangeValidator 控件。submit() 函数可检测页面是否有效。如果有效，则在 Label 控件中返回 "The page is valid!"。如果无效，则在 Label 控件中返回 "The page is not valid!"。如果验证失败，则在 RangeValidator 控件中显示 "The value must be from 1 to 100!"。 

  1. <script  runat="server">
  2. Sub submit(sender As Object, e As EventArgs)
  3. If Page.IsValid Then
  4.    lbl1.Text="页面有效。"
  5. Else
  6.    lbl1.Text="页面无效！"
  7. End If
  8. End Sub
  9. </script>
  11. <html>
  12. <body>
  14. <form runat="server">
  15. 请输入 1 到 100 之间的数字：
  16. <asp:TextBox id="tbox1" runat="server" />
  17. <br /><br />
  18. <asp:Button Text="提交" OnClick="submit" runat="server" />
  19. <br /><br />
  20. <asp:Label id="lbl1" runat="server" />
  21. <br />
  22. <asp:RangeValidator
  23. ControlToValidate="tbox1"
  24. MinimumValue="1"
  25. MaximumValue="100"
  26. Type="Integer"
  27. EnableClientScript="false"
  28. Text="该值必须在 1 到 100 之间。"
  29. runat="server" />
  30. </form>
  32. </body>
  33. </html>