Comment : contrôler l'affichage des messages d'erreur de validation pour les contrôles serveur ASP.NET
Mise à jour : novembre 2007
Dans Microsoft Visual Web Developer, vous pouvez afficher le texte du message d'erreur de quatre manières différentes, comme décrit dans le tableau suivant.
Méthode d'affichage |
Description |
|---|---|
Inline |
Le message d'erreur apparaît en regard du contrôle, à l'emplacement du contrôle de validation. |
Résumé |
Le message d'erreur est affiché dans un résumé distinct de toutes les erreurs, accessible uniquement lorsque l'utilisateur envoie la page. Le message d'erreur peut éventuellement apparaître dans un message, mais cette option est uniquement disponible dans les navigateurs qui prennent en charge le DHTML (dynamic HTML). |
En ligne et résumé |
Le message d'erreur peut être différent selon qu'il est dans le résumé ou en ligne. Vous pouvez utiliser cette option pour afficher un message d'erreur en ligne plus court (avec des détails supplémentaires dans le résumé) ou pour afficher un glyphe d'erreur en regard du champ d'entrée et un message d'erreur dans le résumé. |
Personnalisé |
Vous pouvez créer votre propre affichage de messages d'erreur. Pour plus d'informations, consultez Comment : afficher des messages de validation personnalisés côté serveur pour les contrôles serveur ASP.NET. |
Si vous souhaitez afficher des messages d'erreur résumés, vous devez ajouter un contrôle à la page.
Pour afficher des messages d'erreur résumés
Ajoutez un contrôle ValidationSummary à la page, à l'endroit où vous souhaitez afficher les messages d'erreur collectés.
Utilisez les propriétés ErrorMessage et Display du contrôle de validation.
Définissez la propriété DisplayMode du contrôle de résumé pour mettre en forme les messages d'erreur en utilisant l'une des valeurs suivantes qui sont définies dans l'énumération ValidationSummaryDisplayMode:
Valeur
Affichage
BulletList
(Par défaut) Chaque message d'erreur s'affiche dans une liste à puces.
List
Chaque message d'erreur s'affiche sur sa propre ligne.
SingleParagraph
Chaque message d'erreur s'affiche en tant que phrase dans un paragraphe.
Si vous associez des contrôles de validation aux groupes de validation, vous devrez utiliser un seul contrôle ValidationSummary pour chaque groupe de validation.
Pour afficher des messages d'erreur en ligne et sous la forme de résumé, vous devez définir des combinaisons différentes de propriétés dans les contrôles de validation individuels.
Pour afficher des messages d'erreur en ligne et résumés
Ajoutez un contrôle ValidationSummary comme décrit dans la procédure précédente.
Affectez aux propriétés ErrorMessage, Text et Display des contrôles de validation les valeurs indiquées dans le tableau suivant :
Option
Requiert le contrôle ValidationSummary
Définition des propriétés du contrôle de validation
Inline uniquement
No
Display = Static ou Dynamic
ErrorMessage = <texte d'erreur> ou Text = <texte d'erreur>
Résumé uniquement (avec option boîte de message)
Oui
Display = None
ErrorMessage = <texte d'erreur> ou Text = <texte d'erreur>
Inline et résumé (avec option boîte de message)
Oui
Display = Static ou Dynamic
ErrorMessage = <texte d'erreur pour le résumé>
Text = <texte d'erreur inline ou glyphe>
Si le client exécute un navigateur qui prend en charge DHTML, les messages d'erreur résumés peuvent également apparaître dans un message.
Pour afficher des messages d'erreur résumés dans une boîte de message
Affectez à la propriété ShowMessageBox du contrôle ValidationSummary la valeur true.
Lorsque l'utilisateur envoie la page, les erreurs s'affichent dans le contrôle ValidationSummary et dans le message.
Pour afficher des messages d'erreur résumés uniquement dans un message, affectez false à la propriété ShowSummary.
Voir aussi
Tâches
Comment : spécifier la présentation des messages sur place des contrôles serveur ASP.NET
Référence
Validation des entrées d'utilisateur dans des pages Web ASP.NET