RangeValidator, contrôle (Référence générale)
Mise à jour : novembre 2007
Analyse la valeur d'un contrôle d'entrée pour déterminer si elle est comprise entre les limites inférieure et supérieure spécifiées.
<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"
/>
Notes
Le contrôle RangeValidator peut être utilisé pour vérifier si l'entrée d'un utilisateur est comprise entre les limites inférieure et supérieure spécifiées. Vous pouvez vérifier les plages comprises entre deux nombres, deux caractères alphabétiques ou deux dates. Les limites sont exprimées sous forme de constantes.
Utilisez la propriété ControlToValidate pour spécifier le contrôle d'entrée à valider. Les propriétés MinimumValue et MaximumValue spécifient respectivement les valeurs minimale et maximale de la plage valide.
La propriété Type est utilisée pour spécifier le type de données des valeurs à comparer. Les valeurs à comparer sont converties dans ce type de données avant que la comparaison n'ait lieu.
.gif "Remarque") Remarque : |
|---|
Si le contrôle d'entrée est vide, aucune fonction de validation n'est appelée et la validation s'effectue correctement. Utilisez un contrôle RequiredFieldValidator pour empêcher l'utilisateur d'omettre un contrôle d'entrée. |
| Remarque : |
|---|
Le contrôle RangeValidator lève une exception si la valeur spécifiée par la propriété MaximumValue ou MinimumValue ne peut pas être convertie vers le type de données spécifié par la propriété Type. Par exemple, lorsque la propriété Type d'un contrôle RangeValidator a la valeur "Currency", les propriétés MinimumValue et MaximumValue doivent être fournies sous un format tel que celui décrit dans NumberFormatInfo.CurrencyDecimalDigits ; sinon, une exception est levée. |
Pour plus d'informations sur le contrôle RangeValidator, consultez la classe System.Web.UI.WebControls.RangeValidator.
Exemple
L'exemple de code suivant montre comment utiliser le contrôle RangeValidator pour vérifier si la valeur entrée dans une zone de texte est comprise entre un et dix. Le résultat de la validation s'affiche ensuite sur la page.
.gif "Note de sécurité") Note de sécurité : |
|---|
Cet exemple a une zone de texte qui accepte l'entrée d'utilisateur, ce qui constitue une menace éventuelle pour la sécurité. Par défaut, les pages Web ASP.NET vérifient que les entrées d'utilisateur n'incluent pas de script ou d'éléments HTML. Pour plus d'informations, consultez Vue d'ensemble des attaques de 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>