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
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