HtmlSelect.SelectedIndex Property

 

Gets or sets the ordinal index of the selected item in an HtmlSelect control.

Namespace:   System.Web.UI.HtmlControls
Assembly:  System.Web (in System.Web.dll)

[<BrowsableAttribute(false)>]
abstract SelectedIndex : int with get, set
[<BrowsableAttribute(false)>]
override SelectedIndex : int with get, set

Property Value

Type: System.Int32

The ordinal index of the selected item in an HtmlSelect control. A value of -1 indicates that no item is selected.

Exception Condition
ArgumentOutOfRangeException

The property was set to a value greater than the number of items in the HtmlSelect control or less than -1.

The SelectedIndex property is commonly used to determine the index of the selected item in a single-selection HtmlSelect control. This index can then be used to retrieve the item from the Items collection.

If the Multiple property is set to true, indicating that multiple items can be concurrently selected, the SelectedIndex property contains the index of the first selected item. To determine the selected items from an HtmlSelect control that allows multiple simultaneous selections, iterate through the Items collection and test the ListItem.Selected property of each item.

System_CAPS_cautionCaution

It is possible to have no item selected. If no item is selected, the SelectedIndex property contains a value of -1. This commonly occurs when the page first loads and an item is not selected by default. Provide code to test this value before referencing the item in the Items collection. Otherwise, an exception is thrown if the index is out of the range of the collection.

By default, the HtmlSelect control is displayed as a drop-down list box. If you allow multiple selections (by setting the Multiple property to true) or specify a height greater than one row (by setting the Size property to a value greater than 1), the control is displayed as a list box. If a drop-down list box is displayed, an item is always selected. If a list box is displayed, you can programmatically clear the selection from all items by setting the SelectedIndex property to -1.

The following code example demonstrates how to use the SelectedIndex property to determine the index of the selected item in the HtmlSelect control. The index is then used to retrieve the selected item from the Items collection.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 1.1
Return to top
Show: