BaseValidator, classe

La classe BaseValidator fournit l'implémentation principale pour tous les contrôles de validation. Les contrôles de validation sont utilisés pour valider l'entrée d'utilisateur dans un contrôle d'entrée associé. Lorsque la validation de la valeur entrée par l'utilisateur échoue, le contrôle de validation affiche un message d'erreur. Étant donné que le contrôle de validation est distinct du contrôle d'entrée, vous pouvez placer le message d'erreur n'importe où sur la page relative au contrôle d'entrée. ASP.NET fournit plusieurs contrôles de validation qui exécutent des types de validations spécifiques. Le tableau suivant décrit ces contrôles.

Les contrôles de validation valident toujours le contrôle d'entrée associé sur le serveur. Ils bénéficient également d'une implémentation côté client qui permet aux navigateurs activés pour les scripts (tels que Microsoft Internet Explorer 4.0 et versions ultérieures) d'effectuer une validation sur le client. La validation côté client améliore le processus de validation en vérifiant l'entrée d'utilisateur avant qu'elle soit envoyée au serveur. Cela permet de détecter d'éventuelles erreurs sur le client avant d'envoyer le formulaire, évitant ainsi l'aller-retour des informations, nécessaire à une validation côté serveur.

Plusieurs contrôles de validation peuvent être utilisés avec un contrôle d'entrée individuel pour valider différents critères. Par exemple, vous pouvez appliquer plusieurs contrôles de validation sur un contrôle TextBox. Vous pouvez utiliser un contrôle RangeValidator pour vous assurer que la valeur entrée dans le contrôle TextBox est comprise dans une plage définie et un contrôle RequiredFieldValidator pour vous assurer que l'utilisateur entre une valeur.

ASP.NET fournit de nombreux contrôles ayant la capacité de publier sur le serveur. Lorsque la valeur true est affectée à la propriété CausesValidation de l'un de ces contrôles, la validation est exécutée lorsque le contrôle publie sur le serveur. Les contrôles suivants ont la capacité de publier sur le serveur :

• System.Web.UI.WebControls.BulletedList

• System.Web.UI.WebControls.Button

• System.Web.UI.WebControls.CheckBox

• System.Web.UI.WebControls.CheckBoxList

• System.Web.UI.WebControls.DropDownList

• System.Web.UI.HtmlControls.HtmlButton

• System.Web.UI.HtmlControls.HtmlInputButton

• System.Web.UI.HtmlControls.HtmlInputImage

• System.Web.UI.WebControls.ImageButton

• System.Web.UI.WebControls.LinkButton

• System.Web.UI.WebControls.ListBox

• System.Web.UI.WebControls.RadioButtonList

• System.Web.UI.WebControls.TextBox

Remarque
Certains de ces contrôles publient sur le serveur seulement lorsque la valeur true est affectée à la propriété AutoPostBack.

Chacun de ces contrôles a une propriété ValidationGroup qui, lorsqu'elle est définie, valide seulement les contrôles de validation dans le groupe spécifié, lorsque le contrôle déclenche une publication sur le serveur. Pour grouper des contrôles de validation,affectez la même valeur à la propriété ValidationGroup de chaque contrôle de validation.

Pour associer un contrôle d'entrée à un contrôle de validation, utilisez la propriété ControlToValidate. Pour spécifier le texte à afficher dans un contrôle de validation lorsque la validation échoue, utilisez la propriété Text. Vous pouvez également afficher un résumé de tous les contrôles pour lesquels la validation a échoué dans la page à l'aide d'un contrôle ValidationSummary. Pour spécifier le texte à afficher dans un contrôle ValidationSummary, utilisez la propriété ErrorMessage.

Remarque
Si vous définissez la propriété ErrorMessage sans définir la propriété Text, la valeur de la propriété ErrorMessage s'affiche également dans le contrôle de validation.

Lorsque vous utilisez des contrôles validateurs, vous devriez toujours vérifier les résultats de validation côté serveur avant d'exécuter tout traitement. Après une publication, mais avant que vos méthodes d'événement ne soient appelées, la page appelle les contrôles validateurs et regroupe leurs résultats dans la propriété Page.IsValid. (Vous pouvez également appeler explicitement les contrôles validateurs à l'aide de la méthode Validate.) Dans votre propre code, vous devriez vérifier que la propriété Page.IsValid retourne true avant de traiter une entrée. Bien que les navigateurs activés pour les scripts puissent empêcher une publication de se produire sur le client si la validation a échoué, vous devriez également toujours vérifier Page.IsValid dans le code serveur avant de traiter des données validées.

Vous pouvez également exécuter la validation manuellement. Pour valider tous les contrôles de validation sur la page, utilisez la méthode Page.Validate. Les contrôles de validation peuvent être validés à l'aide de la méthode Validate du contrôle.

Remarque

Si vous utilisez la propriété Page.IsValid dans une méthode Page_Load, vous devez d'abord appeler explicitement la méthode Page.Validate. Étant donné que la validation se produit après l'événement Control.Load pour la page mais avant le gestionnaire d'événements pour les événements Click ou Command, la propriété Page.IsValid n'est pas mise à jour tant que la méthode Page.Validate n'est pas appelée. Vous pouvez également placer votre code dans le gestionnaire d'événements pour l'événement Click ou Command au lieu de la méthode Page_Load.

Tous les contrôles serveur Web ne prennent pas en charge les contrôles de validation. Les contrôles standard qui peuvent être validés avec un contrôle de validation sont :

• System.Web.UI.WebControls.DropDownList

• System.Web.UI.WebControls.FileUpload

• System.Web.UI.WebControls.ListBox

• System.Web.UI.WebControls.RadioButtonList

• System.Web.UI.WebControls.TextBox

• System.Web.UI.HtmlControls.HtmlInputFile

• System.Web.UI.HtmlControls.HtmlInputPassword

• System.Web.UI.HtmlControls.HtmlInputText

• System.Web.UI.HtmlControls.HtmlSelect

• System.Web.UI.HtmlControls.HtmlTextArea

Remarque
Pour qu'un contrôle d'entrée soit validé, l'attribut System.Web.UI.ValidationPropertyAttribute doit être appliqué au contrôle.

Remarque
Lors de l'utilisation de contrôles validateur dérivés de BaseValidator au sein d'un contrôle UpdatePanel, veillez à ce que le contrôle du validateur et le contrôle auquel il est associé se trouvent dans le même volet. Pour plus d'informations sur l'utilisation du contrôle UpdatePanel pour les mises à jour de pages partielles, consultez Partial-Page Rendering Overview.

Lorsque la validation échoue, vous pouvez définir le focus sur le contrôle d'entrée associé en affectant la valeur true à la propriété SetFocusOnError.

Pour obtenir la liste des valeurs de propriétés initiales d'une instance de BaseValidator, consultez le constructeur BaseValidator.

Accessibilité

Lorsque vous héritez de la classe BaseValidator, vous devez substituer le membre suivant : EvaluateIsValid.

L'exemple de code suivant illustre comment utiliser plusieurs contrôles de validation pour vérifier que l'utilisateur entre une valeur valide dans un contrôle TextBox.

Note de sécurité
Cet exemple a une zone de texte qui accepte l'entrée d'utilisateur, ce qui constitue une menace éventuelle pour la sécurité. Par défaut, les pages Web ASP.NET vérifient que les entrées d'utilisateur n'incluent pas de script ou d'éléments HTML. Pour plus d'informations, consultez Script Exploits Overview.

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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  void Button_Click(Object sender, EventArgs e) 
  {
    if (Page.IsValid)
    {
      MessageLabel.Text = "Page submitted successfully.";
    }
    else
    {
      MessageLabel.Text = "There is an error on the page.";
    }
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>Validator Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>Validator Example</h3>

      Enter a number from 1 to 10.
      <asp:textbox id="NumberTextBox" 
        runat="server"/>

      <asp:rangevalidator id="NumberCompareValidator" 
        controltovalidate="NumberTextBox"
        enableclientscript="False"  
        type="Integer"
        display="Dynamic" 
        errormessage="Please enter a value from 1 to 10."
        maximumvalue="10"
        minimumvalue="1"  
        text="*"
        runat="server"/>

      <asp:requiredfieldvalidator id="TextBoxRequiredValidator" 
        controltovalidate="NumberTextBox"
        enableclientscript="False"
        display="Dynamic" 
        errormessage="Please enter a value."
        text="*"
        runat="server"/>

      <br /><br />

      <asp:button id="SubmitButton"
        text="Submit"
        onclick="Button_Click"
        runat="server"/>

      <br /><br />

      <asp:label id="MessageLabel" 
        runat="server"/>

      <br /><br />

      <asp:validationsummary
        id="ErrorSummary"
        runat="server"/>

    </form>
  </body>
</html>

.NET Framework

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Référence