ASP.NET ListItem Control

|  | Search W3Schools : |

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

ADVERTISEMENTS XML Certification Download XML editor Custom Programming |  |

Table of contents

ASP.NET Tutorial
.NET HOME
.NET Intro
.NET vs ASP
.NET Install
.NET Pages
.NET Controls
.NET Events
ASP.NET Forms
.NET Forms
.NET ViewState
asp:TextBox
asp:Button
ASP.NET Binding
Data Binding
ArrayList
Hashtable
SortedList
XML Files
asp:Repeater
asp:DataList
ASP.NET Database
.NET DB Connection
ASP.NET 2.0
2.0 New Features
2.0 Master Pages
2.0 Navigation
References
HTML Controls
Web Controls
Validation Controls
Examples
ASP.NET Examples

Selected Reading

Web Statistics
Web Glossary
Web Hosting
Web Quality
W3Schools Tutorials
W3Schools Forum
Helping W3Schools

# ASP.NET ListItem Control

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.

Complete Web Control Reference

## Reliable, affordable, feature-rich web hosting!

Take the uncertainty out of Web hosting and let GoDaddy.com put service, performance and value back in. No matter which hosting type or plan you choose, your site receives 24/7 maintenance and protection in our world-class data center. Plus, you get the expert, friendly service you deserve, from the world's largest hostname provider.

With three plans to choose from and prices starting at just $4.99 per month, GoDaddy.com is sure to have a plan that's right-sized and right-priced just for you!

All plans feature FREE 24x7 setup, FREE 24x7 monitoring, best- of-breed routers, firewalls and servers, 24x7 onsite physical security and access to our exclusive Go Daddy Hosting Connection, THE place to install over 30 FREE applications. Virtual Dedicated and Dedicated Server plans also available. Visit GoDaddy.com today.

Virtual Dedicated, Dedicated Server and unlimited plans also available.

Save 10% on web hosting - Enter code w3tenoff at checkout

## Get Your Diploma!

W3Schools' Online Certification Program is the perfect solution for busy professionals who need to balance work, family, and career building.

The HTML Certificate is for developers who want to document their knowledge of HTML, XHTML, and CSS.

The JavaScript Certificate is for developers who want to document their knowledge of JavaScript and the HTML DOM.

The XML Certificate is for developers who want to document their knowledge of XML, XML DOM and XSLT.

The ASP Certificate is for developers who want to document their knowledge of ASP, SQL, and ADO.

The PHP Certificate is for developers who want to document their knowledge of PHP and SQL (MySQL).

WEB HOSTING
Web based charting for ASP.NET
$15 Domain Name Registration Save $20 / year!
Buy UK Domain Names Register Domain Names
Cheap Domain Names Cheap Web Hosting
Best Web Hosting
PHP MySQL Hosting
Top 10 Web Hosting
UK Reseller Hosting
Web Hosting
FREE Web Hosting

WEB BUILDING
Website Templates Flash Templates Website Builder Internet Business Opportunity
Custom Programming
FREE Trial or Demo Web Content Manager Forms,Web Alerts,RSS
Download XML editor
FREE Flash Website
FREE Web Templates

EDUCATION
US Web Design Schools
HTML Certification
JavaScript Certification
XML Certification
PHP Certification
ASP Certification

HOME or Top of Page |  | Printer Friendly
W3Schools is for training only. We do not warrant the correctness of its content. The risk from using it lies entirely with the user. While using this site, you agree to have read and accepted our terms of use and privacy policy. Copyright 1999-2009 by Refsnes Data. All Rights Reserved.