Controllo RangeValidator

Valuta se il valore di un controllo di input è compreso tra i limiti inferiore e superiore specificati.

<asp:RangeValidator 
     id="ProgrammaticID" 
     ControlToValidate="ProgrammaticID of control to validate" 
     MinimumValue="value"
     MaximumValue="value" 
     Type="DataType" 
     ErrorMessage="Message to display in ValidationSummary control"
     Text="Message to display in control"
     ForeColor="value" 
     BackColor="value" ... 
     runat="server" >
</asp:RangeValidator>

Osservazioni

Il controllo RangeValidator consente di verificare se la voce immessa dall'utente è compresa tra i limiti inferiore e superiore specificati. È possibile verificare gli intervalli all'interno di coppie di numeri, caratteri alfabetici e date. I limiti possono essere espressi sotto forma di costanti.

Utilizzare la proprietà ControlToValidate per specificare il controllo di input da convalidare. Le proprietà MinimumValue e MaximumValue specificano rispettivamente i valori minimo e massimo dell'intervallo valido.

La proprietà Type è utilizzata per specificare il tipo di dati dei valori da confrontare. I valori da confrontare vengono convertiti in questo tipo di dati prima che venga eseguito qualsiasi confronto.

Nota   Se il controllo di input è vuoto, non viene chiamata alcuna funzione di convalida e la convalida ha esito positivo. Utilizzare un controllo RequiredFieldValidator per impedire all'utente di ignorare un controllo di input. Allo stesso modo, se il valore del controllo di input non può essere convertito in un tipo di dati specifico mediante la proprietà Type, la convalida ha ugualmente esito positivo. È assolutamente consigliabile utilizzare un controllo CompareValidator supplementare, con la proprietà Operator impostata su ValidationCompareOperator.DataTypeCheck, per verificare il tipo di dati del valore di input.

**Nota   **Il controllo RangeValidator genera un'eccezione se il valore specificato dalla proprietà MaximumValue o MinimumValue non può essere convertito nel tipo di dati specificato dalla proprietà Type.

Per ulteriori informazioni sul controllo RangeValidator, vedere la classe RangeValidator.

Esempio

Nell'esempio seguente viene descritto come utilizzare un controllo RangeValidator per convalidare se il valore immesso in una casella di testo è compreso tra uno e dieci. Il risultato della convalida è quindi visualizzato sulla pagina.

<%@ 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>
[C#]
<%@ 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>

Vedere anche

Classe RangeValidator | Controlli server di convalida