Compartilhar via


Controle RangeValidator (referência geral)

Avalia o valor de um controle de entrada para determinar se ele está entre os limites superiores e inferiores especificados.

<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"
/>

Comentários

The RangeValidator controle permite que você verificar se uma entrada do usuário está entre um superior especificado e um limite inferior especificado. Você pode verificar a extensão através de pares de números, caracteres em ordem alfabética, ou datas. sistema autônomo limites são expressas sistema autônomo constantes.

Use o ControlToValidate propriedade para especificar o controle de entrada para validar. The MinimumValue e MaximumValue Propriedades de especificam os valores mínimos e máximo do intervalo válido, respectivamente.

The Type propriedade é usada para especificar o tipo de dados dos valores para comparar. Os valores para comparar são convertidos para esse tipo de dados antes que qualquer comparação seja efetuada.

ObservaçãoObservação:

Se o controle de entrada estiver vazio, nenhuma função de validação é chamadas e validação tiver êxito. Use um RequiredFieldValidator controle para impedir que o usuário ignorando um controle de entrada.

ObservaçãoObservação:

O RangeValidator controle lança uma exceção se o valor especificado pela MaximumValue ou MinimumValue propriedade não pode ser convertida em tipo de dados especificado pela Type propriedade. Por exemplo, quando um RangeValidator do controle Typepropriedade estiver definida sistema autônomo "Moeda", o MinimumValue e MaximumValue propriedades devem ser fornecidas em um formato, sistema autônomo descrito em NumberFormatInfo.CurrencyDecimalDigits, caso contrário uma exceção é lançada.

Para obter mais informações sobre o RangeValidator controle, consulte o System.Web.UI.WebControls.RangeValidator classe.

Exemplo

The following code example demonstrates how to use theRangeValidator control to validate whether the value entered in a text box is between one and ten. O resultado da validação, em seguida, é exibido na página.

Observação de segurançaObservação de segurança:

Este exemplo tem uma caixa de texto que aceita entrada do usuário, que é uma ameaça potencial de segurança. Por padrão, páginas Web ASP.NET validam se as entradas de usuário não incluem scripts ou elementos HTML. Para obter mais informações, consulte Visão Geral de Scripts Maliciosos.

<%@ 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>   

Consulte também

Referência

RangeValidator

Outros recursos

Validação de sintaxe de controle de servidor