Propriétés de base des contrôles de validation

Mise à jour : novembre 2007

Les propriétés répertoriées dans le tableau suivant s'appliquent à tous les contrôles de validation.

Propriétés

ControlToValidate	ID programmatique du contrôle d'entrée analysé par le contrôle de validation. Si cet ID n'est pas valide, une exception est levée.
Display	Mode d'affichage du contrôle de validation spécifié. Cette propriété peut avoir l'une des valeurs suivantes : None — Le contrôle de validation ne s'affiche jamais inline. Utilisez cette option lorsque vous souhaitez afficher uniquement le message d'erreur dans un contrôle ValidationSummary. Static — Le contrôle de validation affiche un message d'erreur en cas d'échec de la validation. Un espace est alloué au message d'erreur sur la page Web même si le contrôle d'entrée a été validé. La présentation de la page n'est ainsi pas modifiée lorsque le contrôle de validation affiche le message d'erreur. Dans la mesure où la présentation de la page est statique, plusieurs contrôles de validation associés au même contrôle d'entrée doivent occuper des emplacements différents sur la page. Dynamic — Le contrôle de validation affiche un message d'erreur en cas d'échec de la validation. L'espace sur la page destiné au message d'erreur est alloué dynamiquement lorsque la validation échoue. Plusieurs contrôles de validation peuvent ainsi partager le même emplacement sur la page. Remarque : Dans la mesure où l'espace nécessaire au contrôle de validation est créé dynamiquement, la disposition physique de la page change. Pour éviter que la disposition de la page ne change lors de l'affichage d'un contrôle de validation, l'élément HTML comportant le contrôle doit être suffisamment grand pour pouvoir s'adapter à la taille maximale du contrôle de validation.
EnableClientScript	Indique si la validation côté client est activée. Vous pouvez désactiver la validation côté client sur les navigateurs qui prennent en charge cette fonctionnalité en affectant à la propriété EnableClientScript la valeur false.
Enabled	Indique si le contrôle de validation est activé. Vous pouvez empêcher le contrôle de validation de valider un contrôle d'entrée en affectant la valeur false à cette propriété.
ErrorMessage	Message d'erreur à afficher dans le contrôle ValidationSummary en cas d'échec de la validation. Si la propriété Text du contrôle de validation n'est pas définie, ce texte s'affiche également dans le contrôle de validation en cas d'échec de la validation. La propriété ErrorMessage est généralement utilisée pour fournir différents messages pour le contrôle de validation et le contrôle ValidationSummary. Remarque : Cette propriété ne convertit pas les caractères spéciaux en entités HTML. Ainsi, le signe inférieur à (<) n'est pas converti en &lt;. Vous pouvez donc incorporer des éléments HTML, comme l'élément <img>, à la valeur de la propriété.
ForeColor	Spécifie la couleur à utiliser pour afficher le message inline en cas d'échec de la validation.
IsValid	Indique si le contrôle d'entrée spécifié par la propriété ControlToValidate est identifié comme étant valide.
SetFocusOnError	Indique si le contrôle spécifié par la propriété ControlToValidate a le focus lorsque la validation échoue.
Text	Lorsque la propriété est définie, ce message s'affiche dans le contrôle de validation en cas d'échec de la validation. Dans le cas contraire, le texte spécifié dans la propriété ErrorMessage s'affiche dans le contrôle.
ValidationGroup	Spécifie le nom du groupe de validation auquel ce contrôle de validation appartient.

Voir aussi

Référence

BaseValidator

Autres ressources

Syntaxe des contrôles serveur de validation