RegularExpressionValidator, 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

RegularExpressionValidator, classe

Valide si la valeur d'un contrôle d'entrée associé correspond au modèle spécifié par une expression régulière.

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)

Syntaxe

Visual Basic (Déclaration)

Public Class RegularExpressionValidator
    Inherits BaseValidator

Visual Basic (Utilisation)

Dim instance As RegularExpressionValidator

public class RegularExpressionValidator : BaseValidator

C++

public ref class RegularExpressionValidator : public BaseValidator

public class RegularExpressionValidator extends BaseValidator

JScript

public class RegularExpressionValidator extends BaseValidator

Notes

Le contrôle RegularExpressionValidator vérifie si la valeur d'un contrôle d'entrée correspond à un modèle défini par une expression régulière. Ce type de validation vous permet de rechercher des séquences de caractères prévisibles, comme celles qui se trouvent dans les adresses électroniques, les numéros de téléphone et les codes postaux.

Remarque
La validation est réussie lorsque le contrôle d'entrée est vide. Si une valeur est obligatoire pour le contrôle d'entrée associé, utilisez un contrôle RequiredFieldValidator en plus du contrôle RegularExpressionValidator.

La validation est effectuée côté serveur et côté client sauf si le navigateur ne prend pas en charge la validation côté client ou si cette dernière est explicitement désactivée (en affectant false à la propriété EnableClientScript).

L'implémentation de la validation de l'expression régulière est légèrement différente sur le client par rapport à celle sur le serveur. Sur le client, la syntaxe de l'expression régulière JScript est utilisée. Sur le serveur, la syntaxe System.Text.RegularExpressions.Regex est utilisée. Étant donné que la syntaxe de l'expression régulière JScript est un sous-ensemble de la syntaxe System.Text.RegularExpressions.Regex, son utilisation est recommandée afin de produire les mêmes résultats sur le client et le serveur.

Pour plus d'informations sur les contrôles de validation, consultez BaseValidator. Pour plus d'informations sur les expressions régulières, consultez Expressions régulières du .NET Framework.

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 : 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 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 l'utilisation du contrôle RegularExpressionValidator pour valider un code postal à cinq chiffres.

Visual Basic

<%@ Page Language="VB" AutoEventWireup="True" %>

 <html>
 <head>

    <script runat="server">
 
       Sub ValidateBtn_Click(sender As Object, e As EventArgs) 
       
          If Page.IsValid Then 
          
             lblOutput.Text = "Page is Valid."
          
          Else 
          
             lblOutput.Text = "Page is InValid."

          End If

       End Sub
 
    </script>
 
 </head>
 <body>
 
    <h3>RegularExpressionValidator Example</h3>
    <p>
 
    <form runat="server">
 
       <table bgcolor="#eeeeee" cellpadding="10">
          <tr valign="top">
             <td colspan="3">
                <asp:Label ID="lblOutput" 
                     Text="Enter a 5 digit zip code" 
                     runat="server"/>
             </td>
          </tr>
 
          <tr>
             <td colspan="3">
                <b>Personal Information</b>
             </td>
          </tr>
          <tr>
             <td align="right">
                Zip Code:
             </td>
             <td>
                <asp:TextBox id="TextBox1" 
                     runat="server"/>
             </td>
             <td>
                <asp:RegularExpressionValidator id="RegularExpressionValidator1" 
                     ControlToValidate="TextBox1"
                     ValidationExpression="\d{5}"
                     Display="Static"
                     ErrorMessage="Zip code must be 5 numeric digits"
                     EnableClientScript="False" 
                     runat="server"/>
             </td>
          </tr>
          <tr>
             <td></td>
             <td>
                <asp:Button text="Validate" 
                     OnClick="ValidateBtn_Click" 
                     runat=server />
             </td>
             <td></td>
          </tr>
       </table>
 
    </form>
 
 </body>
 </html>

<%@ Page Language="C#" AutoEventWireup="True" %>

 <html>
 <head>

    <script runat="server">
 
       void ValidateBtn_Click(Object sender, EventArgs e) 
       {
          if (Page.IsValid) 
          {
             lblOutput.Text = "Page is Valid.";
          }
          else 
          {
             lblOutput.Text = "Page is InValid.";
          }
       }
 
    </script>
 
 </head>
 <body>
 
    <h3>RegularExpressionValidator Example</h3>
    <p>
 
    <form runat="server">
 
       <table bgcolor="#eeeeee" cellpadding="10">
          <tr valign="top">
             <td colspan="3">
                <asp:Label ID="lblOutput" 
                     Text="Enter a 5 digit zip code" 
                     runat="server"/>
             </td>
          </tr>
 
          <tr>
             <td colspan="3">
                <b>Personal Information</b>
             </td>
          </tr>
          <tr>
             <td align="right">
                Zip Code:
             </td>
             <td>
                <asp:TextBox id="TextBox1" 
                     runat="server"/>
             </td>
             <td>
                <asp:RegularExpressionValidator id="RegularExpressionValidator1" 
                     ControlToValidate="TextBox1"
                     ValidationExpression="\d{5}"
                     Display="Static"
                     ErrorMessage="Zip code must be 5 numeric digits"
                     EnableClientScript="False" 
                     runat="server"/>
             </td>
          </tr>
          <tr>
             <td></td>
             <td>
                <asp:Button text="Validate" 
                     OnClick="ValidateBtn_Click" 
                     runat=server />
             </td>
             <td></td>
          </tr>
       </table>
 
    </form>
 
 </body>
 </html>

JScript

<%@ Page Language="JScript" AutoEventWireup="True" %>

 <html>
 <head>

    <script runat="server">
 
       function ValidateBtn_Click(sender : Object, e : EventArgs) 
       {
          if (Page.IsValid) 
          {
             lblOutput.Text = "Page is Valid.";
          }
          else 
          {
             lblOutput.Text = "Page is InValid.";
          }
       }
 
    </script>
 
 </head>
 <body>
 
    <h3>RegularExpressionValidator Example</h3>
    <p>
 
    <form runat="server">
 
       <table bgcolor="#eeeeee" cellpadding="10">
          <tr valign="top">
             <td colspan="3">
                <asp:Label ID="lblOutput" 
                     Text="Enter a 5 digit zip code" 
                     runat="server"/>
             </td>
          </tr>
 
          <tr>
             <td colspan="3">
                <b>Personal Information</b>
             </td>
          </tr>
          <tr>
             <td align="right">
                Zip Code:
             </td>
             <td>
                <asp:TextBox id="TextBox1" 
                     runat="server"/>
             </td>
             <td>
                <asp:RegularExpressionValidator id="RegularExpressionValidator1" 
                     ControlToValidate="TextBox1"
                     ValidationExpression="\d{5}"
                     Display="Static"
                     ErrorMessage="Zip code must be 5 numeric digits"
                     EnableClientScript="False" 
                     runat="server"/>
             </td>
          </tr>
          <tr>
             <td></td>
             <td>
                <asp:Button text="Validate" 
                     OnClick="ValidateBtn_Click" 
                     runat=server />
             </td>
             <td></td>
          </tr>
       </table>
 
    </form>
 
 </body>
 </html>

Sécurité .NET Framework

AspNetHostingPermission pour opérer dans un environnement hébergé. Valeur de la demande : LinkDemand. Valeur d'autorisation : Minimal.
AspNetHostingPermission pour opérer dans un environnement hébergé. Valeur de la demande : InheritanceDemand. Valeur d'autorisation : Minimal.

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.RegularExpressionValidator

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 RegularExpressionValidator
System.Web.UI.WebControls, espace de noms
BaseValidator, classe
BaseValidator.EnableClientScript, propriété
System.Text.RegularExpressions.Regex

Autres ressources

Expressions régulières du .NET Framework

Mots clés

: Ajouter un mot clé

Contenu de la communauté

Ajouter du contenu

Annotations

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