RangeValidator, classe (System.Web.UI.WebControls)

Réduire tout

Filtre de language

Cette page est spécifique à

Microsoft Visual Studio 2005/.NET Framework 2.0

D'autres versions sont également disponibles pour :

Microsoft Visual Studio 2008/.NET Framework 3.5

Bibliothèque de classes .NET Framework

RangeValidator, classe

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)

Syntaxe

Visual Basic (Déclaration)

Public Class RangeValidator
    Inherits BaseCompareValidator

Visual Basic (Utilisation)

Dim instance As RangeValidator

public class RangeValidator : BaseCompareValidator

C++

public ref class RangeValidator : public BaseCompareValidator

public class RangeValidator extends BaseCompareValidator

JScript

public class RangeValidator extends BaseCompareValidator

Notes

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.

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.

Topic	Location
Comment : afficher des messages de validation personnalisés côté serveur pour les contrôles serveur ASP.NET	Génération d'applications Web ASP.NET
Comment : afficher des messages de validation personnalisés côté serveur pour les contrôles serveur ASP.NET	Génération d'applications Web ASP.NET dans Visual Studio
Comment : désactiver la validation pour les contrôles serveur ASP.NET	Génération d'applications Web ASP.NET
Comment : désactiver la validation pour les contrôles serveur ASP.NET	Génération d'applications Web ASP.NET dans Visual Studio
Comment : mettre en forme les messages d'erreur de validation pour les contrôles serveur ASP.NET	Génération d'applications Web ASP.NET
Comment : mettre en forme les messages d'erreur de validation pour les contrôles serveur ASP.NET	Génération d'applications Web ASP.NET dans Visual Studio
Comment : spécifier la présentation des messages sur place des contrôles serveur ASP.NET	Génération d'applications Web ASP.NET
Comment : spécifier la présentation des messages sur place des contrôles serveur ASP.NET	Génération d'applications Web ASP.NET dans Visual Studio
Comment : tester par programme la validité pour les contrôles serveur ASP.NET	Génération d'applications Web ASP.NET
Comment : tester par programme la validité pour les contrôles serveur ASP.NET	Génération d'applications Web ASP.NET dans Visual Studio
Comment : valider à l'aide d'une fonction personnalisée pour les contrôles serveur ASP.NET	Génération d'applications Web ASP.NET
Comment : valider à l'aide d'une fonction personnalisée pour les contrôles serveur ASP.NET	Génération d'applications Web ASP.NET dans Visual Studio
Comment : valider des entrées requises pour les contrôles serveur ASP.NET	Génération d'applications Web ASP.NET
Comment : valider des entrées requises pour les contrôles serveur ASP.NET	Génération d'applications Web ASP.NET dans Visual Studio
Comment : valider par programme les contrôles serveur ASP.NET	Génération d'applications Web ASP.NET
Comment : valider par programme les contrôles serveur ASP.NET	Génération d'applications Web ASP.NET dans Visual Studio
Comment : valider par rapport à des modèles pour les contrôles serveur ASP.NET	Génération d'applications Web ASP.NET
Comment : valider par rapport à des modèles pour les contrôles serveur ASP.NET	Génération d'applications Web ASP.NET dans Visual Studio
Comment : valider par rapport à des valeurs d'une base de données pour les contrôles serveur ASP.NET	Génération d'applications Web ASP.NET
Comment : valider par rapport à des valeurs d'une base de données pour les contrôles serveur ASP.NET	Génération d'applications Web ASP.NET dans Visual Studio
Comment : valider par rapport à un type de données pour les contrôles serveur ASP.NET	Génération d'applications Web ASP.NET
Comment : valider par rapport à un type de données pour les contrôles serveur ASP.NET	Génération d'applications Web ASP.NET dans Visual Studio
Comment : valider par rapport à une plage de valeurs pour les contrôles serveur ASP.NET	Génération d'applications Web ASP.NET
Comment : valider par rapport à une plage de valeurs pour les contrôles serveur ASP.NET	Génération d'applications Web ASP.NET dans Visual Studio
Comment : valider par rapport à une valeur spécifique pour les contrôles serveur ASP.NET	Génération d'applications Web ASP.NET
Comment : valider par rapport à une valeur spécifique pour les contrôles serveur ASP.NET	Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : validation des entrées d'utilisateur dans une page Web Forms	Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : validation des entrées d'utilisateur dans une page Web Forms	Génération d'applications à l'aide de Visual Web Developer

Exemple

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.

Visual Basic

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

Hiérarchie d'héritage

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

Sécurité des threads

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.

Plates-formes

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.

Informations de version

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

Voir aussi

Référence

Membres RangeValidator
System.Web.UI.WebControls, espace de noms
BaseValidator.ControlToValidate, propriété
MaximumValue
MinimumValue
BaseCompareValidator.Type, propriété
RequiredFieldValidator
BaseValidator, classe

Mots clés

: Ajouter un mot clé

Contenu de la communauté

Ajouter du contenu

Annotations

Gérer votre profil | Contactez-nous | Newsletter MSDN