RangeValidator 控件(常规参考)

[本文档仅供预览,在以后的发行版中可能会发生更改。包含的空白主题用作占位符。]

计算输入控件的值,以确定该值是否在指定的上限与下限之间。

<asp:RangeValidator
    AccessKey="string"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    ControlToValidate="string"
    CssClass="string"
    CultureInvariantValues="True|False"
    Display="None|Static|Dynamic"
    EnableClientScript="True|False"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    ErrorMessage="string"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
        Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    Height="size"
    ID="string"
    MaximumValue="string"
    MinimumValue="string"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    runat="server"
    SetFocusOnError="True|False"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    Text="string"
    ToolTip="string"
    Type="String|Integer|Double|Date|Currency"
    ValidationGroup="string"
    Visible="True|False"
    Width="size"
/>

备注

RangeValidator 控件使您可以检查用户的输入是否在指定的上限与下限之间。 可以检查数字对、字母对和日期对限定的范围。 边界表示为常数。

使用 ControlToValidate 属性来指定要验证的输入控件。 MinimumValueMaximumValue 属性分别指定有效范围的最小值和最大值。

Type 属性用于指定要比较的值的数据类型。 在执行任何比较之前,先将要比较的值转换为该数据类型。

备注

如果输入控件为空,则不会调用任何验证函数,并且验证将成功。使用 RequiredFieldValidator 控件防止用户跳过某个输入控件。

备注

如果 MaximumValueMinimumValue 属性指定的值无法转换为 Type 属性指定的数据类型,则 RangeValidator 控件将引发异常。例如,如果 RangeValidator 控件的 Type 属性设置为“Currency”,则 MinimumValueMaximumValue 属性必须以 NumberFormatInfo.CurrencyDecimalDigits 中介绍的格式提供,否则会引发异常。

有关 RangeValidator 控件的更多信息,请参见 System.Web.UI.WebControls.RangeValidator 类。

示例

下面的代码示例演示如何使用RangeValidator 控件验证在文本框中输入的值是否介于 1 和 10 之间。 验证结果随后显示在页上。

安全说明安全说明

该示例具有一个文本框,用于接受用户输入,这是一个潜在的安全威胁。默认情况下,ASP.NET 网页验证用户输入是否不包括脚本或 HTML 元素。有关更多信息,请参见Script Exploits Overview

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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >

<head>
<title>RangeValidator Control (General Reference)</title>

   <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 id="Form1" 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"/>

      <p />

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

      <p />

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


   </form>

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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >

<head>
<title>RangeValidator Control (General Reference)</title>

   <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 id="Form1" 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"/>

      <p />

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

      <p />

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


   </form>

</body>
</html>   

请参见

参考

RangeValidator

其他资源

验证服务器控件语法