This documentation is archived and is not being maintained.

BaseValidator.Enabled Property

Gets or sets a value that indicates whether the validation control is enabled.

[Visual Basic]
Overrides Public Property Enabled As Boolean
[C#]
public override bool Enabled {get; set;}
[C++]
public: __property bool get_Enabled();
public: __property void set_Enabled(bool);
[JScript]
public override function get Enabled() : Boolean;
public override function set Enabled(Boolean);

Property Value

true if the validation control is enabled; otherwise, false.

Remarks

Use the Enabled property to specify whether the validation control is enabled. You can programmatically disable the validation control by setting this property to false.

Setting either the Control.Visible or Enabled properties to false will prevent validation from being performed. This causes the IsValid property to always evaluate to true.

The Enabled property is slightly different from Control.Visible property. If the Control.Visible property for a validation control is set to true, but the Enabled property is set to false, the validation control is still rendered for client-side validation, but in a disabled state. You can then re-enable the validation control on the client by using DHTML script.

Example

[Visual Basic, C#, JScript] The following example demonstrates how to use the Enabled property to enable or disable the validation controls on the Web page.

[Visual Basic] 
<%@ Page Language="VB" AutoEventWireup="True" %>
 
<html>
<head>
   <script runat="server">
 
      Sub Button_Click(sender As Object, e As EventArgs) 

         Dim rand_number As Random = New Random()

         Compare1.ValueToCompare = rand_number.Next(1, 10).ToString()
         Compare1.Validate()
 
         If (Page.IsValid) Then
            lblOutput.Text = "You guessed correctly!!"
         Else
            lblOutput.Text = "You guessed poorly"
         End If

         lblOutput.Text &= "<br><br>" & "The number is: " & Compare1.ValueToCompare

      End Sub

      Sub Enable_Button_Click(sender As Object, e As EventArgs) 

         Require1.Enabled = Not(Require1.Enabled)
         Compare1.Enabled = Not(Compare1.Enabled)
         
         If (Require1.Enabled) Then
            Label1.Text = "Validation Enabled"
         Else
            Label1.Text = "Validation Disabled"
         End If

      End Sub
 
   </script>
 
</head>
<body>
 
   <form runat=server>

      <h3>Validator Example</h3>

      <h5>Pick a number between 1 and 10:</h5>

      <asp:RequiredFieldValidator id="Require1" 
           ControlToValidate="TextBox1"
           Type="Integer"
           ForeColor="Blue"
           EnableClientScript="False"  
           ErrorMessage="No number entered!!"
           Text="*"
           runat="server"/>
     
      <asp:TextBox id="TextBox1" 
           runat="server"/>

      <asp:CompareValidator id="Compare1" 
           ControlToValidate="TextBox1"
           ValueToCompare="0"             
           Type="Integer"
           ForeColor="Blue"
           EnableClientScript="False"   
           ErrorMessage="Incorrect guess!!"
           Text="*"
           runat="server"/>

      <br><br>

      <asp:Button id="Button1"
           Text="Submit"
           OnClick="Button_Click"
           runat="server"/>

      <asp:Button id="Button2"
           Text="Enable/Disable Validation"
           OnClick="Enable_Button_Click"
           runat="server"/>

      <asp:Label id="Label1"  
           runat="server"/>
 
      <br><br>
       
      <asp:Label id="lblOutput" 
           Font-Name="verdana" 
           Font-Size="10pt" 
           runat="server"/>

      <br><br>

      <asp:ValidationSummary
           id="Summary1"
           runat="server"/>
 
   </form>
 
</body>
</html>
   

[C#] 
<%@ Page Language="C#" AutoEventWireup="True" %>
 
<html>
<head>
   <script runat="server">
 
      void Button_Click(Object sender, EventArgs e) 
      {

         Random rand_number = new Random();

         Compare1.ValueToCompare = rand_number.Next(1, 10).ToString();
         Compare1.Validate();
 
         if (Page.IsValid) 
         {
            lblOutput.Text = "You guessed correctly!!";
         }
         else 
         {
            lblOutput.Text = "You guessed poorly";
         }

         lblOutput.Text += "<br><br>" + "The number is: " + Compare1.ValueToCompare;

      }

      void Enable_Button_Click(Object sender, EventArgs e) 
      {

         Require1.Enabled = !Require1.Enabled;
         Compare1.Enabled = !Compare1.Enabled;
         
         if (Require1.Enabled)
            Label1.Text = "Validation Enabled";
         else
            Label1.Text = "Validation Disabled";

      }
 
   </script>
 
</head>
<body>
 
   <form runat=server>

      <h3>Validator Example</h3>

      <h5>Pick a number between 1 and 10:</h5>

      <asp:RequiredFieldValidator id="Require1" 
           ControlToValidate="TextBox1"
           Type="Integer"
           ForeColor="Blue"
           EnableClientScript="False" 
           ErrorMessage="No number entered!!"
           Text="*"
           runat="server"/>
     
      <asp:TextBox id="TextBox1" 
           runat="server"/>

      <asp:CompareValidator id="Compare1" 
           ControlToValidate="TextBox1"
           ValueToCompare="0"             
           Type="Integer"
           ForeColor="Blue"
           EnableClientScript="False"   
           ErrorMessage="Incorrect guess!!"
           Text="*"
           runat="server"/>

      <br><br>

      <asp:Button id="Button1"
           Text="Submit"
           OnClick="Button_Click"
           runat="server"/>

      <asp:Button id="Button2"
           Text="Enable/Disable Validation"
           OnClick="Enable_Button_Click"
           runat="server"/>

      <asp:Label id="Label1"  
           runat="server"/>
 
      <br><br>
       
      <asp:Label id="lblOutput" 
           Font-Name="verdana" 
           Font-Size="10pt" 
           runat="server"/>

      <br><br>

      <asp:ValidationSummary
           id="Summary1"
           runat="server"/>
 
   </form>
 
</body>
</html>
   

[JScript] 
<%@ Page Language="JScript" AutoEventWireup="True" %>
 
<html>
<head>
   <script language="JScript" runat="server">
 
      function Button_Click(sender, e : EventArgs) 
      {

         var rand_number : Random = new Random();

         Compare1.ValueToCompare = rand_number.Next(1, 10).ToString();
         Compare1.Validate();
 
         if (Page.IsValid) 
         {
            lblOutput.Text = "You guessed correctly!!";
         }
         else 
         {
            lblOutput.Text = "You guessed poorly";
         }

         lblOutput.Text += "<br><br>" + "The number is: " + Compare1.ValueToCompare;

      }

      function Enable_Button_Click(sender, e : EventArgs) 
      {

         Require1.Enabled = !Require1.Enabled;
         Compare1.Enabled = !Compare1.Enabled;
         
         if (Require1.Enabled)
            Label1.Text = "Validation Enabled";
         else
            Label1.Text = "Validation Disabled";

      }
 
   </script>
 
</head>
<body>
 
   <form runat=server>

      <h3>Validator Example</h3>

      <h5>Pick a number between 1 and 10:</h5>

      <asp:RequiredFieldValidator id="Require1" 
           ControlToValidate="TextBox1"
           Type="Integer"
           ForeColor="Blue" 
           ErrorMessage="No number entered!!"
           Text="*"
           runat="server"/>
     
      <asp:TextBox id="TextBox1" 
           runat="server"/>

      <asp:CompareValidator id="Compare1" 
           ControlToValidate="TextBox1"
           ValueToCompare="0"             
           Type="Integer"
           ForeColor="Blue"  
           ErrorMessage="Incorrect guess!!"
           Text="*"
           runat="server"/>

      <br><br>

      <asp:Button id="Button1"
           Text="Submit"
           OnClick="Button_Click"
           runat="server"/>

      <asp:Button id="Button2"
           Text="Enable/Disable Validation"
           OnClick="Enable_Button_Click"
           runat="server"/>

      <asp:Label id="Label1"  
           runat="server"/>
 
      <br><br>
       
      <asp:Label id="lblOutput" 
           Font-Name="verdana" 
           Font-Size="10pt" 
           runat="server"/>

      <br><br>

      <asp:ValidationSummary
           id="Summary1"
           runat="server"/>
 
   </form>
 
</body>
</html>
   

[C++] No example is available for C++. To view a Visual Basic, C#, or JScript example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 2000, Windows XP Professional, Windows Server 2003 family

See Also

BaseValidator Class | BaseValidator Members | System.Web.UI.WebControls Namespace

Show: