Vous êtes actuellement hors ligne, en attente de reconnexion à Internet.

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

Ancien nº de publication de cet article : F316662
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.

retour au début

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
retour au début

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=NoneEnableClientScript=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=valEmailAddressControlToValidate=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.
retour au début

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.
retour au début
Propriétés

ID d'article : 316662 - Dernière mise à jour : 06/10/2003 14:59:00 - Révision : 2.0

Microsoft ASP .NET (inclus dans le .NET Framework), Microsoft Visual Basic .NET 2002 Initiation, Microsoft Visual Studio .NET 2002 Professional Edition

  • kberrmsg kbhowto kbhowtomaster kbinfo KB316662
Commentaires