RangeValidator 类

项目
08/17/2007

检查输入控件的值是否在指定的值范围内。

**命名空间:**System.Web.UI.WebControls
**程序集:**System.Web（在 system.web.dll 中）

语法

声明
Public Class RangeValidator
    Inherits BaseCompareValidator
用法
Dim instance As RangeValidator

public class RangeValidator : BaseCompareValidator

public ref class RangeValidator : public BaseCompareValidator

public class RangeValidator extends BaseCompareValidator

public class RangeValidator extends BaseCompareValidator

备注

RangeValidator 控件测试输入控件的值是否在指定范围内。

RangeValidator 控件使用四个关键属性执行验证。ControlToValidate 属性包含要验证的输入控件。MinimumValue 和 MaximumValue 属性指定有效范围的最大值和最小值。

BaseCompareValidator.Type 属性用于指定要比较的值的数据类型。在执行验证操作之前，要比较的值被转换为此数据类型。下表列出了可以进行比较的不同数据类型。

数据类型	说明
String	字符串数据类型。
Integer	32 位有符号整数数据类型。
Double	双精度浮点数数据类型。
Date	日期数据类型。
Currency	一种可以包含货币符号的十进制数据类型。

提示

如果输入控件为空，则表明验证成功。使用 RequiredFieldValidator 控件使该输入控件成为强制字段。

提示

如果 MaximumValue 或 MinimumValue 属性指定的值无法转换为指定的 BaseCompareValidator.Type，则 RangeValidator 控件将引发异常。

有关验证控件的附加信息，请参见 BaseValidator。

辅助功能

默认情况下，为此控件呈现的标记可能不符合辅助功能标准，例如 Web 内容辅助功能准则 1.0 (WCAG) 优先级 1 准则。有关此控件的辅助功能支持的详细信息，请参见 ASP.NET 控件和辅助功能。

主题	位置
演练：验证 Web 窗体页中的用户输入	在 Visual Studio 中构建 ASP .NET Web 应用程序
演练：验证 Web 窗体页中的用户输入	使用 Visual Web Developer 生成应用程序
如何：对照数据库中的值验证 ASP.NET 服务器控件	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：对照取值范围验证 ASP.NET 服务器控件	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：对照特定值验证 ASP.NET 服务器控件	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：对照数据类型验证 ASP.NET 服务器控件	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：指定 ASP.NET 服务器控件上就地消息的布局	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：验证 ASP.NET 服务器控件的必需项	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：显示 ASP.NET 服务器控件的服务器端自定义验证消息	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：以编程方式测试 ASP.NET 服务器控件的有效性	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：根据模式对 ASP.NET 服务器控件进行验证	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：以编程方式验证 ASP.NET 服务器控件	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：设置 ASP.NET 服务器控件的验证错误信息的格式	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：使用自定义函数对 ASP.NET 服务器控件进行验证	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：禁用 ASP.NET 服务器控件验证	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：对照数据库中的值验证 ASP.NET 服务器控件	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：对照取值范围验证 ASP.NET 服务器控件	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：对照特定值验证 ASP.NET 服务器控件	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：对照数据类型验证 ASP.NET 服务器控件	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：指定 ASP.NET 服务器控件上就地消息的布局	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：验证 ASP.NET 服务器控件的必需项	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：显示 ASP.NET 服务器控件的服务器端自定义验证消息	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：以编程方式测试 ASP.NET 服务器控件的有效性	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：根据模式对 ASP.NET 服务器控件进行验证	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：以编程方式验证 ASP.NET 服务器控件	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：设置 ASP.NET 服务器控件的验证错误信息的格式	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：使用自定义函数对 ASP.NET 服务器控件进行验证	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：禁用 ASP.NET 服务器控件验证	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：对照数据库中的值验证 ASP.NET 服务器控件	生成 ASP .NET Web 应用程序
如何：对照取值范围验证 ASP.NET 服务器控件	生成 ASP .NET Web 应用程序
如何：对照特定值验证 ASP.NET 服务器控件	生成 ASP .NET Web 应用程序
如何：对照数据类型验证 ASP.NET 服务器控件	生成 ASP .NET Web 应用程序
如何：指定 ASP.NET 服务器控件上就地消息的布局	生成 ASP .NET Web 应用程序
如何：验证 ASP.NET 服务器控件的必需项	生成 ASP .NET Web 应用程序
如何：显示 ASP.NET 服务器控件的服务器端自定义验证消息	生成 ASP .NET Web 应用程序
如何：以编程方式测试 ASP.NET 服务器控件的有效性	生成 ASP .NET Web 应用程序
如何：根据模式对 ASP.NET 服务器控件进行验证	生成 ASP .NET Web 应用程序
如何：以编程方式验证 ASP.NET 服务器控件	生成 ASP .NET Web 应用程序
如何：设置 ASP.NET 服务器控件的验证错误信息的格式	生成 ASP .NET Web 应用程序
如何：使用自定义函数对 ASP.NET 服务器控件进行验证	生成 ASP .NET Web 应用程序
如何：禁用 ASP.NET 服务器控件验证	生成 ASP .NET Web 应用程序

示例

下面的示例说明如何在网页上创建 RangeValidator 控件，以检查输入到输入控件的值是否在比较范围内。

<%@ Page Language="VB" AutoEventWireup="True" %>

<html>

<head>

   <script runat="server">

      Sub ButtonClick(sender As Object, e As EventArgs)

         If Page.IsValid Then
         
            Label1.Text="Page is valid."
         
         Else
         
            Label1.Text="Page is not valid!!"
         
         End If

      End Sub

   </script>

</head>

<body>

   <form runat="server">

      <h3>RangeValidator Example</h3>

      Enter a number from 1 to 10:

      <br>

      <asp:TextBox id="TextBox1"
           runat="server"/>

      <br>

      <asp:RangeValidator id="Range1"
           ControlToValidate="TextBox1"
           MinimumValue="1"
           MaximumValue="10"
           Type="Integer"
           EnableClientScript="false"
           Text="The value must be from 1 to 10!"
           runat="server"/>

      <br><br>

      <asp:Label id="Label1"
           runat="server"/>

      <br><br>

      <asp:Button id="Button1"
           Text="Submit"
           OnClick="ButtonClick"
           runat="server"/>
            

   </form>

</body>
</html>

<%@ Page Language="C#" AutoEventWireup="True" %>

<html>

<head>

   <script runat="server">

      void ButtonClick(Object sender, EventArgs e)
      {

         if (Page.IsValid)
         {
            Label1.Text="Page is valid.";
         }
         else
         {
            Label1.Text="Page is not valid!!";
         }

      }

   </script>

</head>

<body>

   <form runat="server">

      <h3>RangeValidator Example</h3>

      Enter a number from 1 to 10:

      <br>

      <asp:TextBox id="TextBox1"
           runat="server"/>

      <br>

      <asp:RangeValidator id="Range1"
           ControlToValidate="TextBox1"
           MinimumValue="1"
           MaximumValue="10"
           Type="Integer"
           EnableClientScript="false"
           Text="The value must be from 1 to 10!"
           runat="server"/>

      <br><br>

      <asp:Label id="Label1"
           runat="server"/>

      <br><br>

      <asp:Button id="Button1"
           Text="Submit"
           OnClick="ButtonClick"
           runat="server"/>
            

   </form>

</body>
</html>

继承层次结构

System.Object
   System.Web.UI.Control
     System.Web.UI.WebControls.WebControl
       System.Web.UI.WebControls.Label
         System.Web.UI.WebControls.BaseValidator
           System.Web.UI.WebControls.BaseCompareValidator
            System.Web.UI.WebControls.RangeValidator

线程安全

此类型的任何公共静态（Visual Basic 中的 Shared）成员都是线程安全的，但不保证所有实例成员都是线程安全的。

平台

Windows 98、Windows 2000 SP4、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。

版本信息

.NET Framework

受以下版本支持：2.0、1.1、1.0

请参见

参考

RangeValidator 成员
 System.Web.UI.WebControls 命名空间
 BaseValidator.ControlToValidate 属性
 MaximumValue
MinimumValue
BaseCompareValidator.Type 属性
 RequiredFieldValidator
BaseValidator 类

通过