Controllo RangeValidator (riferimento generale)
Aggiornamento: novembre 2007
Valuta se il valore di un controllo di input è compreso tra i limiti inferiore e superiore specificati.
<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"
/>
Note
Il controllo RangeValidator consente di verificare se la voce immessa dall'utente è compresa tra i limiti inferiore e superiore specificati. È possibile verificare gli intervalli compresi tra 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 viene 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.
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. Ad esempio, quando la proprietà Type di un controllo RangeValidator è impostata su "Currency", le proprietà MinimumValue e MaximumValue devono essere fornite in un formato come quello descritto in NumberFormatInfo.CurrencyDecimalDigits. In caso contrario, verrà generata un'eccezione.
Per ulteriori informazioni sul controllo RangeValidator, vedere la classe System.Web.UI.WebControls.RangeValidator.
Esempio
Nell'esempio di codice riportato di seguito viene descritto come utilizzare il controlloRangeValidator per convalidare se il valore immesso in una casella di testo è compreso tra uno e dieci. Il risultato della convalida è quindi visualizzato sulla pagina.
.gif "Nota sulla sicurezza") Nota sulla sicurezza: |
|---|
L'esempio include una casella di testo che accetta l'input dell'utente e rappresenta quindi una potenziale minaccia alla sicurezza. Per impostazione predefinita, le pagine Web ASP.NET verificano che l'input dell'utente non includa script o elementi HTML. Per ulteriori informazioni, vedere Cenni preliminari sugli attacchi tramite script. |
<%@ 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>