A ListItem control is an individual data item within a data-bound list control, such as a ListBox or DropDownList control.
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in System.Web.dll)
Property |
Description |
Supported in .NET version |
Attributes |
Returns a collection of attribute name and value pairs for the ListItem that are not directly supported by the class. Web developers can use the Attributes collection to manage pairs of attribute name and value declared in the opening and closing tags of the control, but not directly supported by the class. They can programmatically add or remove attributes to the collection. |
1.0,1.1, 2.0, 3.0, 3.5, 4.0 |
Enabled |
This property is used to get or set a value indicating whether the list item is enabled. Its default value is false. Its value is true if the list item is enabled; otherwise, false. A ListItem control that is disabled is dimmed to indicate that it cannot be selected. Web developers can this property to disable a ListItem control in either a RadioButtonList control or a CheckBoxList control, but they cannot use this property to disable a ListItem control in a DropDownList control or ListBox control. |
2.0, 3.0, 3.5, 4.0 |
Selected |
This property gets or sets a value indicating whether the item is selected. Its default value is false. Its value is true if the item is selected; otherwise, false. Web developers commonly use this property, when they are iterating through a collection of ListItem objects in a list control, to determine whether an item is selected. |
1.0,1.1, 2.0, 3.0, 3.5, 4.0 |
Text |
The property is used to get or set the text displayed in a list control for the item represented by the ListItem. Its default value is String.Empty. Note: If the Text property contains a null reference (Nothing in VB.NET), the get accessor returns the value of the Value property. If the Value property, in turn, contains a null reference (Nothing in VB.NET), String.Empty is returned. |
1.0,1.1, 2.0, 3.0, 3.5, 4.0 |
Value |
Returns or sets the value associated with the ListItem. Its default value is String.Empty. If the Value property contains a null reference (Nothing in VB.NET), the get accessor returns the value of the Text property. If the Text property, in turn, contains a null reference (Nothing in VB.NET), String. Empty is returned. |
1.0,1.1, 2.0, 3.0, 3.5, 4.0 |