From http://www.w3schools.com (Copyright Refsnes Data)
Complete Web Control Reference
The ListItem control creates an item in a list.
This control is used with the list controls such as <asp:ListBox>, <asp:RadioButtonList> and <asp:BulletedList>
|
<asp:ListItem Enabled="True|False" Selected="True|False" Text="label" Value="value" /> |
| Property | Description | .NET |
|---|---|---|
| Attributes | Optional. A collection of attribute name and value pairs for the ListItem that are not directly supported by the class | 1.0 |
| Enabled | Optional. Specifies if the item is enabled or disabled | 2.0 |
| Selected | Optional. Specifies whether or not the item is selected | 1.0 |
| Text | Optional. The text displayed in the ListItem | 1.0 |
| Value | Optional. The value of the the ListItem. | 1.0 |
| AccessKey, Attributes, BackColor, BorderColor, BorderStyle, BorderWidth, CssClass, Enabled, Font, EnableTheming, ForeColor, Height, IsEnabled, SkinID, Style, TabIndex, ToolTip, Width |
For a full description, go to Web Control Standard Attributes.
| AppRelativeTemplateSourceDirectory, BindingContainer, ClientID, Controls, EnableTheming, EnableViewState, ID, NamingContainer, Page, Parent, Site, TemplateControl, TemplateSourceDirectory, UniqueID, Visible |
For a full description, go to Control Standard Attributes.
It is possible to use the Text or Value properties and the inner HTML text to set the text displayed for an item in the list.
| <asp:ListItem Value="Text1" Text="Text2">Text3</asp:ListItem> |
Depending on the combination of the three, different texts are shown and values used. The table below shows all possible combinations and their results:
| Inner HTML | Text Property | Value Property | Text Shown | Value Used |
|---|---|---|---|---|
| Set | Set | Set | Inner HTML | Value Property |
| Set | Set | Not set | Inner HTML | Inner HTML |
| Set | Not set | Set | Inner HTML | Value Property |
| Set | Not set | Not set | Inner HTML | Inner HTML |
| Not set | Set | Set | Text Property | Value Property |
| Not set | Set | Not set | Text Property | Text Property |
| Not set | Not set | Set | Value Property | Value Property |
| Not set | Not set | Not set | Not set | Not set |
Note: The Text and Value properties have a default value of an empty string. Because of this it is possible to have empty list items.
Basic ListItem
in BulletedList
This example shows a BulletedList control with two ListItems in an .aspx file.
ListItems
with different properties in ListBox
This example shows a ListBox control with some ListItems in an .aspx file. The
items in the list uses different properties to show the ListItem text.
ListItem disabled in ListBox
This example shows a ListBox control with one of the ListItems disabled.
ListItem selected in RadioButtonList
This example shows a RadioButtonList control with one of the ListItems selected.
Complete Web Control Reference
From http://www.w3schools.com (Copyright Refsnes Data)