w3schools
  
HOME HTML CSS XML JAVASCRIPT ASP PHP SQL MORE...   References Examples Forum About

ASP.NET ListItem Control


Web Control Reference Complete Web Control Reference

Definition and Usage

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>


Syntax

<asp:ListItem
Enabled="True|False"
Selected="True|False"
Text="label"
Value="value" />

Properties

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

Web Control Standard Properties

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.

Control Standard Properties

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.

Example

<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


Tips and Notes

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.


Examples

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.


Web Control Reference Complete Web Control Reference

Make your web applications look like a million bucks

FusionCharts   

Most web applications today use boring methods to present data to their viewers using grids or simple HTML tables. FusionCharts induces "life" into the web applications by converting monotonous data into lively charts, gauges & maps.

FusionCharts works with all technologies like ASP, ASP.NET, PHP, ColdFusion, Ruby on Rails, JSP, HTML pages etc. and connects to any database to render animated & interactive charts. It takes less than 15 minutes and no expertise whatsoever to build your first chart and just a glance of it to captivate your audience. This fact is endorsed by our 12,000 customers and 150,000 users which include a majority of the Fortune 500 companies. And yeah, your applications could look like a million bucks by spending just $69.

So go ahead, download your copy of FusionCharts and start "wow-ing" your customers now!



W3Schools Certification

W3Schools' Online Certification Program

The perfect solution for professionals who need to balance work, family, and career building.

More than 4000 certificates already issued!

The HTML Certificate documents your knowledge of HTML, XHTML, and CSS.

The JavaScript Certificate documents your knowledge of JavaScript and HTML DOM.

The XML Certificate documents your knowledge of XML, XML DOM and XSLT.

The ASP Certificate documents your knowledge of ASP, SQL, and ADO.

The PHP Certificate documents your knowledge of PHP and SQL (MySQL).

WEB HOSTING
Best Web Hosting
PHP MySQL Hosting
Top 10 Web Hosting
UK Reseller Hosting
Web Hosting
FREE Web Hosting
Top Web Hosting
Windows Hosting
WEB BUILDING
XML Editor – Free Trial!
FREE Flash Website
FREE Web Templates
FLIGHT TICKETS
Find the cheapest flight
to any destination now!
EDUCATION
US Web Design Schools
HTML Certification
JavaScript Certification
XML Certification
PHP Certification
ASP Certification
STATISTICS
Browser Statistics
Browser OS
Browser Display