ListView.SelectedIndex Property

Reference

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.Extensions.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets or sets the index of the selected item in a ListView control.

public:
 virtual property int SelectedIndex { int get(); void set(int value); };

public virtual int SelectedIndex { get; set; }

member this.SelectedIndex : int with get, set

Public Overridable Property SelectedIndex As Integer

Property Value

Int32

The zero-based index of the selected item in a ListView control. The default is -1, which indicates that no item is currently selected.

Exceptions

ArgumentOutOfRangeException

The SelectedIndex property is set to a value less than -1.

Examples

The following example shows how to use the SelectedIndex property to determine whether an item is selected in a ListView control. This code example is part of a larger example provided for the DeleteItem method.

protected void DeleteButton_Click(object sender, EventArgs e)
{
  //Check if an item is selected to delete it.
  if (ContactsListView.SelectedIndex >= 0)
    ContactsListView.DeleteItem(ContactsListView.SelectedIndex);
  else
    Message.Text = "No contact was selected.";
}

Protected Sub DeleteButton_Click(ByVal sender As Object, ByVal e As EventArgs)
  
  ' Check if an item is selected to delete it.
  If ContactsListView.SelectedIndex >= 0 Then
    ContactsListView.DeleteItem(ContactsListView.SelectedIndex)
  Else
    Message.Text = "No contact was selected."
  End If
  
End Sub

Remarks

Use the SelectedIndex property to determine the index of the currently selected item in a ListView control. You can also use this property to programmatically select an item in the control. (However, if you manually data-bind the ListView control, you might have to handle reading or setting this property manually as well.)

Applies to

Product	Versions
.NET Framework	3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Share via