COMMENT FAIRE : Utiliser les contrôles de validation ASP.NET de Visual Studio .NET

Traductions disponibles Traductions disponibles
Numéro d'article: 316662 - Voir les produits auxquels s'applique cet article
Ancien nº de publication de cet article : F316662
Agrandir tout | Réduire tout

Sommaire

Résumé

Lorsqu'ils sont placés dans une page de formulaires Web ASP.NET, les contrôles de validation de .NET Framework permettent non seulement de valider les entrées effectuées par les utilisateurs dans les champs de contrôle mais également d'afficher les messages d'erreur associés à chaque contrôle. Cet article explique comment utiliser les contrôles de validation ASP.NET pour implémenter rapidement et facilement une validation côté client et côté serveur des entrées effectuées par les utilisateurs.

Conditions requises

Vous avez besoin du matériel et des logiciels suivants pour effectuer les procédures décrites dans cet article :
  • Visual Studio .NET
  • Microsoft Internet Information Server (IIS) 5.0 ou ultérieure
Vous devez avoir acquis les connaissances suivantes pour pouvoir exécuter les procédures décrites dans cet article :
  • Connaissance générale des applications Web
  • Connaissance générale de ASP.NET

Utilisation des contrôles de validation ASP.NET à partir de Visual Studio .NET

La validation d'une entrée utilisateur peut être une tâche fastidieuse. Les contrôles de validation de .NET Framework permettent de valider les entrées utilisateurs et d'afficher les messages d'erreur appropriés chaque fois que le contrôle de validation détecte des données non valides. Cela peut devenir un facteur appréciable de gain de temps si vous devez dupliquer cette validation à la fois sur le client et le serveur. En outre, le contrôle ValidationSummary permet d'afficher la totalité des messages d'erreur d'une page dans une zone de l'écran.

Dans les étapes suivantes, vous allez créer une application Web ASP.NET qui invite l'utilisateur à entrer un nom d'utilisateur, une adresse électronique et un mot de passe. Lorsque l'utilisateur soumet les informations demandées, les contrôles de validation du formulaire valident les données saisies par l'utilisateur et affichent les éventuels messages d'erreur dans un récapitulatif au bas de l'écran.
  1. Démarrez Visual Studio .NET.
  2. Créez un projet d'application Web ASP.NET à l'aide de Visual Basic .NET.
  3. Basculez en vue HTML de la fenêtre WebForm1.aspx.
  4. Ajoutez 4 contrôles d'entrée et les messages associés (invites) à votre formulaire pour solliciter une saisie de l'utilisateur. Pour cela, dans la fenêtre HTML WebForm1, copiez et collez le code suivant entre les balises d'ouverture et de fermeture du formulaire.

    REMARQUE : lorsque vous collez le code dans la fenêtre HTML, il est important de coller les segments de code au format HTML. Pour cela, sélectionnez l'option Coller au format HTML dans le menu contextuel.
    <table>
    <tr width=100>
    <td>Nom d'utilisateur :</td>
    <td><input id=txtUserName type=text size=20 maxlength=15 runat=server/>*
    </td>
    </tr>
    
    <tr width=100>
    <td>Adresse électronique :
    <td><input id=txtEmail type=text size=35 maxlength=30 runat=server/>  (personne@microsoft.com)
    </td>
    </tr>
    
    <tr width=100>
    <td>Mot de passe :</td>
    <td><input id=txtPassword type=password size=15 maxlength=10 runat=server/>*
    </td>
    </tr>
    
    <tr width=100>
    <td>Retapez le mot de passe :</td>
    <td><input id=txtConfirmPassword type=password size=15 maxlength=10 runat=server/>*
    </td>
    </tr>
    </table>
  5. Les contrôles RequiredFieldValidator vérifient qu'une valeur a été entrée pour le champ spécifié par le contrôle. Ajoutez des contrôles RequiredFieldValidator à votre formulaire pour les champs Nom d'utilisateur et Mot de passe.

    Dans la fenêtre HTML WebForm1, copiez et collez le code suivant après la balise </table>, toujours en utilisant  Coller au format HTML dans le menu Edition:
    <asp:RequiredFieldValidator id=valUserNameRequired 
    ControlToValidate=txtUserName ErrorMessage="Vous devez entrer un nom d'utilisateur dans ce champ." EnableClientScript=true Display=None Runat=server/>
    		<asp:RequiredFieldValidator id=valPasswordRequired 
    ControlToValidate=txtUserName ErrorMessage="Vous devez entrer un mot de passe dans ce champ." EnableClientScript=true Display=None Runat=server/>
    		<asp:RequiredFieldValidator id=valConfirmPasswordRequired 
    ControlToValidate=txtConfirmPassword ErrorMessage="Vous devez confirmer le mot de passe dans ce champ."
    EnableClientScript=true Display=None Runat=server/>
  6. La vérification des champs de mot de passe s'effectue généralement en demandant à l'utilisateur de taper deux fois le même mot de passe. Le contrôle CompareValidator compare le contenu de deux champs de saisie et génère un message d'erreur en cas de différence. Utilisez un contrôle CompareValidator pour valider les champs de mot de passe.

    Dans la fenêtre HTML WebForm1, copiez et collez le code suivant à la suite des contrôles de validation ajoutés à l'étape 5 :
    <asp:CompareValidator id=valComparePassword 
    ControlToValidate=txtConfirmPassword ErrorMessage="Les champs de mot de passe doivent être identiques." ControlToCompare=txtPassword Display=None
    EnableClientScript=true Runat=server/>
  7. Certains champs (par exemple un champ contenant une adresse électronique) nécessitent parfois une validation plus personnalisée. Le contrôle RegularExpressionValidator s'assure que le format de base personne@microsoft.com est respecté. Le contenu du champ est testé par rapport à une expression régulière et si celui-ci ne correspond pas à la structure de l'expression, un message d'erreur est envoyé à l'utilisateur. Ajoutez un contrôle RegularExpressionValidator pour valider le format de l'adresse électronique entrée par l'utilisateur.

    Dans la fenêtre HTML WebForm1, copiez et collez le code suivant à la suite des contrôles de validation entrées précédemment :
    <asp:RegularExpressionValidator ID=valEmailAddress
    ControlToValidate=txtEmail	ValidationExpression=".*@.*\..*" ErrorMessage="Adresse électronique non valide." 
    Display=None EnableClientScript=true Runat=server/>
  8. Ajoutez un bouton Envoyer pour autoriser l'utilisateur à envoyer la page au serveur et valider le contenu des contrôles du formulaire.

    Dans la fenêtre HTML WebForm1, copiez et collez le code suivant à la suite des contrôles de validation entrées précédemment :
    <br>
    <input type=submit id=cmdSumbit value=submit runat=server/>
  9. Pour finir, le contrôle ValidationSummary permet d'afficher toutes les erreurs rencontrées dans une zone du formulaire.

    Dans la fenêtre HTML WebForm1, copiez et collez le code suivant à la suite du code associé au bouton Envoyer :
    <br><br>
    <asp:ValidationSummary id=ValSummary HeaderText="Les erreurs suivantes ont été trouvées :" ShowSummary=True DisplayMode=List Runat=server/>
  10. Cliquez sur Enregistrer.
  11. Dans le menu Déboguer, cliquez sur Démarrer pour générer et exécuter l'application.

    Form1 est affiché à l'écran.

Vérification

  • Si l'utilisateur clique sur Envoyer sans avoir saisi des valeurs d'entrée, les trois messages d'erreur associés aux champs requis doivent s'afficher.

  • Si l'utilisateur envoie deux valeurs de mot de passe différentes, le message d'erreur "Les champs de mot de passe doivent être identiques" doit s'afficher.

  • Si l'utilisateur envoie une adresse électronique dont le format est incorrect, le message "Adresse électronique non valide" doit s'afficher.

Références

Pour plus d'informations et ressources associées aux contrôles de validation, consultez les sites Web de MSDN suivants :
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/mwdesign/html/mworivalidationcontrols.asp
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/mwdesign/html/mwconintroductiontothevalidationcontrols.asp
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/cpgenref/html/cpconaspnetsyntaxforvalidationcontrols.asp
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/mwdesign/html/mwtskaddingconfiguringsummaryvalidatorcontrol.asp

Propriétés

Numéro d'article: 316662 - Dernière mise à jour: mardi 10 juin 2003 - Version: 2.0
Les informations contenues dans cet article s'appliquent au(x) produit(s) suivant(s):
  • Microsoft ASP .NET (inclus dans le .NET Framework)
  • Microsoft Visual Basic .NET 2002 Initiation
  • Microsoft Visual Studio .NET 2002 Professional Edition
Mots-clés : 
kberrmsg kbhowto kbhowtomaster kbinfo KB316662
L'INFORMATION CONTENUE DANS CE DOCUMENT EST FOURNIE PAR MICROSOFT SANS GARANTIE D'AUCUNE SORTE, EXPLICITE OU IMPLICITE. L'UTILISATEUR ASSUME LE RISQUE DE L'UTILISATION DU CONTENU DE CE DOCUMENT. CE DOCUMENT NE PEUT ETRE REVENDU OU CEDE EN ECHANGE D'UN QUELCONQUE PROFIT.

Envoyer des commentaires

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com