Controls You Can Use on Web Forms   ASP.NET Standard Controls   ListBox Control

NOTE: The information in this topic applies to all list Web server controls: ListBox, DropDownList, RadioButtonList, and CheckBoxList.

You can add items to a list Web server control in these ways:

• Add static items at design time.
• Add items programmatically at run time.
• Add items using data binding. For details, see Populating a List Control from a Database.

When you add a list item, you specify up to three possible properties of the item, as described in the following table.

1. Declare the type of list item element on the page using syntax appropriate to the control.
2. Specify a caption by setting the list item’s Text property.
3. Optionally set the Value property associated with the item.
4. Optionally set which of the list items are initially chosen by setting the control’s Selected property.

Static ListBox Example Run Sample | View Source

CheckBoxList Example Run Sample | View Source

RadioButtonList Example Run Sample | View Source

For more information, see Adding Web Server Controls to a Web Forms Page.

1. Call the Add method of the control’s Items collection and pass it a new object of type ListItem, specifying its Text and Value properties.

   The following example shows how to add a ListItem object to a ListBox control using the value supplied from a TextBox control. This procedure is the same for all the Web server controls that derive from the ListControl class.

void addToList ( object src, EventArgs e ) {
   colorSelect.Items.Add ( txtColor.Value );
}

Sub addToList ( ByVal source As Object, ByVal e As EventArgs )
   colorSelect.Items.Add ( New ListItem ( txtColor.Value ) )
End Sub

Adding Items to a List Control Programmatically Run Sample | View Source

The following examples demonstrate different ways of how you can programmatically add new items to a list control.

WebControl ForeColor and BackColor Properties Example Run Sample | View Source

WebControl BorderWidth Property Run Sample | View Source

Handling Multiple Control Action Events Run Sample View Source

Populating a List Control from a Database   Determining the Selection in a List Control