BaseValidator.Enabled Propriété

Définition

Obtient ou définit une valeur indiquant si le contrôle de validation est activé.

public override bool Enabled { get; set; }

Valeur de propriété

true si le contrôle de validation est activé ; sinon, false. La valeur par défaut est true.

Exemples

L’exemple de code suivant montre comment utiliser la Enabled propriété pour activer ou désactiver les contrôles de validation sur la page Web à l’aide d’un code côté serveur.

Important

Cet exemple comprend une zone de texte qui accepte une entrée d'utilisateur, ce qui constitue une menace potentielle pour la sécurité. Par défaut, les pages web ASP.NET vérifient que l’entrée d’utilisateur n’inclut pas de script ou d’éléments HTML. Pour plus d’informations, consultez Vue d’ensemble des attaques de script.

<%@ 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="*"
        enabled="false"
        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>

L’exemple de code suivant montre comment utiliser la Enabled propriété pour activer ou désactiver les contrôles de validation sur la page Web à l’aide de code côté client.

Remarques

Utilisez la Enabled propriété pour spécifier si le contrôle de validation est activé. Vous pouvez désactiver le contrôle de validation en affectant à cette propriété la valeur false.

La définition de ou Control.Visible de la Enabled propriété sur false empêche la validation d’être effectuée. Ainsi, la IsValid propriété prend toujours la truevaleur .

La Enabled propriété est légèrement différente de la Control.Visible propriété . Si la Control.Visible propriété d’un contrôle de validation a truela valeur , mais que la propriété a falsela Enabled valeur , le contrôle de validation est toujours affiché pour la validation côté client, mais dans un état désactivé. Vous pouvez ensuite réactiver le contrôle de validation sur le client à l’aide d’un script DHTML.

S’applique à

Produit Versions
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1