This documentation is archived and is not being maintained.

ListView.Items Property

Gets a collection of ListViewDataItem objects that represent the data items of the current page of data in a ListView control.

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web.Extensions (in System.Web.Extensions.dll)

[BrowsableAttribute(false)]
public virtual IList<ListViewDataItem> Items { get; }

Property Value

Type: System.Collections.Generic.IList<ListViewDataItem>
An object that contains all the data items of the current page of data in a ListView control.

The Items property is used to store the data items in a ListView control. The ListView control automatically populates the Items collection by creating one ListViewDataItem object for each record in the current page of data in the data source. It then adds each object to the collection. This property is usually used to access a specific item in the control or to iterate though the complete collection of items.

The following example shows how to use the Items collection to access the item that is being edited in a ListView control. This code example is part of a larger example provided for the ItemEditing event.

void ProductsListView_ItemEditing(Object sender, ListViewEditEventArgs e)
{
  ListViewItem item = ProductsListView.Items[e.NewEditIndex];
  Label dateLabel = (Label)item.FindControl("DiscontinuedDateLabel");

  if (String.IsNullOrEmpty(dateLabel.Text))
    return;

  //Verify if the item is discontinued.
  DateTime discontinuedDate = DateTime.Parse(dateLabel.Text);
  if (discontinuedDate < DateTime.Now)
  {
    Message.Text = "You cannot edit a discontinued item.";
    e.Cancel = true;
    ProductsListView.SelectedIndex = -1;
  }       
}

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5
Show: