HtmlControl.Disabled Property

Reference

Definition

Namespace:: System.Web.UI.HtmlControls

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets or sets a value indicating whether the HTML server control is disabled.

public:
 property bool Disabled { bool get(); void set(bool value); };

public bool Disabled { get; set; }

[System.ComponentModel.TypeConverter(typeof(System.Web.UI.MinimizableAttributeTypeConverter))]
public bool Disabled { get; set; }

member this.Disabled : bool with get, set

[<System.ComponentModel.TypeConverter(typeof(System.Web.UI.MinimizableAttributeTypeConverter))>]
member this.Disabled : bool with get, set

Public Property Disabled As Boolean

Property Value

Boolean

true if the control is disabled; otherwise, false. The default value is false.

Attributes: TypeConverterAttribute

Examples

The following code example demonstrates how to use the Disabled property to programmatically enable and disable an HtmlInputButton control.

ASP.NET (C#)

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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>HtmlControl Disabled Property Example</title>
<script language="C#" runat="server">
 
      void Submit_Clicked(Object sender, EventArgs e) 
      {
         
         Message.InnerHtml = "You clicked the submit button.";
 
      }        
      
 
      void Enable_Clicked(Object sender, EventArgs e) 
      {

         Message.InnerHtml = "";
         Submit2.Disabled=!Submit2.Disabled;

      }
 
   </script>
</head>
 
<body>
   <form id="form1" method="post" runat="server">

      <h3>HtmlControl Disabled Property Example</h3>

      <input id="Submit1"        
             type="submit"
             value="Enable/Disable Submit Button"
             onserverclick="Enable_Clicked"
             runat="server"/>

      <br /><br />

      <input id="Submit2"        
             type="submit"
             value="Submit"
             onserverclick="Submit_Clicked"
             runat="server"/>
      
      

      <br /><br />

      <span id="Message" runat="server"/>  
 
   </form>

</body>
</html>

<%@ Page Language="VB" AutoEventWireup="True" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>HtmlControl Disabled Property Example</title>
<script language="VB" runat="server">
    Sub Submit_Clicked(sender As Object, e As EventArgs)
        
        Message.InnerHtml = "You clicked the submit button."
    End Sub 'Submit_Clicked
     
    Sub Enable_Clicked(sender As Object, e As EventArgs)
        
        Message.InnerHtml = ""
        Submit2.Disabled = Not Submit2.Disabled
    End Sub 'Enable_Clicked 
  </script>
</head>
 
<body>
   <form id="form1" method="post" runat="server">

      <h3>HtmlControl Disabled Property Example</h3>

      <input id="Submit1"        
             type="submit"
             value="Enable/Disable Submit Button"
             onserverclick="Enable_Clicked"
             runat="server"/>

      <br /><br />

      <input id="Submit2"        
             type="submit"
             value="Submit"
             onserverclick="Submit_Clicked"
             runat="server"/>
      
      

      <br /><br />

      <span id="Message" runat="server"/>  
 
   </form>

</body>
</html>

Remarks

In the browser, a disabled element or control is read-only, with the following added restrictions: its value is not submitted with the form, the element or control cannot receive focus, and the element or control is skipped when navigating the document by tabbing.

Applies to

Product	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

Share via