HtmlControl.Disabled Property
Definition
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
true
if the control is disabled; otherwise, false
. The default value is false
.
- Attributes
Examples
The following code example demonstrates how to use the Disabled property to programmatically enable and disable an HtmlInputButton control.
<%@ 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.