ListItem::Enabled Property

 

Gets or sets a value indicating whether the list item is enabled.

Namespace:   System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

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

Property Value

Type: System::Boolean

true if the list item is enabled; otherwise, false. The default is true.

The Enabled property allows you to specify whether a ListItem control is enabled or disabled. A ListItem control that is disabled is dimmed to indicate that it cannot be selected. Use this property to disable a ListItem control in either a RadioButtonList control or a CheckBoxList control.

System_CAPS_noteNote

You cannot use this property to disable a ListItem control in a DropDownList control or ListBox control.

The following example demonstrates how to use the Enabled property to programmatically disable list items in a RadioButtonList control. The first question asks the user to select the radio button that corresponds to the user's occupation. If the user indicates that he or she is not a developer, the list items in the second radio button list are disabled. The second question asks the user to select a primary programming language. This question is not relevant to a user that is not a developer.

System_CAPS_noteNote

The following code sample uses the single-file code model and may not work correctly if copied directly into a code-behind file. This code sample must be copied into an empty text file that has an .aspx extension. For more information on the Web Forms code model, see ASP.NET Web Forms Page Code Model.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 2.0
Return to top
Show: