Vérifie si la valeur d'un contrôle d'entrée se trouve dans une plage de valeurs spécifiée.
Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)
Visual Basic (Déclaration)
Public Class RangeValidator
Inherits BaseCompareValidator
Visual Basic (Utilisation)
Dim instance As RangeValidator
public class RangeValidator : BaseCompareValidator
public ref class RangeValidator : public BaseCompareValidator
public class RangeValidator extends BaseCompareValidator
public class RangeValidator extends BaseCompareValidator
Le contrôle RangeValidator teste si la valeur d'un contrôle d'entrée est comprise dans une plage spécifiée.
Le contrôle RangeValidator utilise quatre propriétés principales pour effectuer sa validation. La propriété ControlToValidate contient le contrôle d'entrée à valider. Les propriétés MinimumValue et MaximumValue spécifient les valeurs minimale et maximale de la plage valide.
La propriété BaseCompareValidator.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 l'opération de validation ne soit effectuée. Le tableau suivant énumère les différents types de données pouvant être comparés.
| Type de données | Description |
| String | Type de données chaîne. |
| Integer | Type de données entier signé 32 bits. |
| Double | Type de données nombre à virgule flottante double précision. |
| Date | Type de données date. |
| Currency | Type de données décimal qui peut contenir des symboles monétaires. |
.gif) Remarque |
|---|
| La validation est réussie lorsque le contrôle d'entrée est vide. Utilisez un contrôle RequiredFieldValidator pour convertir le contrôle d'entrée en champ obligatoire. |
| 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 dans le BaseCompareValidator.Type spécifié. |
Pour plus d'informations sur les contrôles de validation, consultez BaseValidator.
Accessibilité
Le balisage rendu par défaut pour ce contrôle peut ne pas se conformer aux normes d'accessibilité telles que les instructions de priorité 1 d'accessibilité du contenu Web (WCAG, Web Content Accessibility Guidelines). Pour plus d'informations sur la prise en charge d'accessibilité pour ce contrôle, consultez Contrôles et accessibilité ASP.NET.
L'exemple suivant illustre la création d'un contrôle RangeValidator sur la page Web pour déterminer si la valeur entrée dans un contrôle d'entrée se trouve dans la plage de comparaison.
<%@ 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>
<%@ 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>
System.Object
System.Web.UI.Control
System.Web.UI.WebControls.WebControl
System.Web.UI.WebControls.Label
System.Web.UI.WebControls.BaseValidator
System.Web.UI.WebControls.BaseCompareValidator
System.Web.UI.WebControls.RangeValidator
Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition
Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.
.NET Framework
Prise en charge dans : 2.0, 1.1, 1.0