Export (0) Print
Expand All

ListItemCollection Class

A collection of ListItem objects in a list control. This class cannot be inherited.

System::Object
  System.Web.UI.WebControls::ListItemCollection

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

public ref class ListItemCollection sealed : IList, 
	ICollection, IEnumerable, IStateManager

The ListItemCollection type exposes the following members.

  NameDescription
Public methodListItemCollectionInitializes a new instance of the ListItemCollection class.
Top

  NameDescription
Public propertyCapacityGets or sets the maximum number of items that the ListItemCollection can store.
Public propertyCountGets the number of ListItem objects in the collection.
Public propertyIsReadOnlyGets a value indicating whether the ListItemCollection is read-only.
Public propertyIsSynchronizedGets a value indicating whether access to the ListItemCollection is synchronized (thread-safe).
Public propertyItemGets a ListItem at the specified index in the collection.
Public propertySyncRootGets the object that can be used to synchronize access to the ListItemCollection.
Top

  NameDescription
Public methodAdd(ListItem)Appends the specified ListItem to the end of the collection.
Public methodAdd(String)Appends a ListItem to the end of the collection that represents the specified string.
Public methodAddRangeAdds the items in an array of ListItem objects to the collection.
Public methodClearRemoves all ListItem objects from the collection.
Public methodContainsDetermines whether the collection contains the specified item.
Public methodCopyToCopies the items from the ListItemCollection to the specified System::Array, starting with the specified index.
Public methodEquals(Object)Determines whether the specified object is equal to the current object. (Inherited from Object.)
Public methodFindByTextSearches the collection for a ListItem with a Text property that equals the specified text.
Public methodFindByValueSearches the collection for a ListItem with a Value property that contains the specified value.
Public methodGetEnumeratorReturns a System.Collections::IEnumerator implemented object that contains all ListItem objects in the ListItemCollection.
Public methodGetHashCodeServes as the default hash function. (Inherited from Object.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Public methodIndexOfDetermines the index value that represents the position of the specified ListItem in the collection.
Public methodInsert(Int32, String)Inserts a ListItem which represents the specified string in the collection at the specified index location.
Public methodInsert(Int32, ListItem)Inserts the specified ListItem in the collection at the specified index location.
Public methodRemove(ListItem)Removes the specified ListItem from the collection.
Public methodRemove(String)Removes a ListItem from the collection that represents the specified string.
Public methodRemoveAtRemoves the ListItem at the specified index from the collection.
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)
Top

  NameDescription
Public Extension MethodAsParallelEnables parallelization of a query. (Defined by ParallelEnumerable.)
Public Extension MethodAsQueryableConverts an IEnumerable to an IQueryable. (Defined by Queryable.)
Public Extension MethodCast<TResult>Casts the elements of an IEnumerable to the specified type. (Defined by Enumerable.)
Public Extension MethodOfType<TResult>Filters the elements of an IEnumerable based on a specified type. (Defined by Enumerable.)
Top

  NameDescription
Explicit interface implemetationPrivate methodIList::AddInfrastructure. For a description of this member, see Add.
Explicit interface implemetationPrivate methodIList::ContainsInfrastructure. For a description of this member, see Contains.
Explicit interface implemetationPrivate methodIList::IndexOfInfrastructure. For a description of this member, see IndexOf.
Explicit interface implemetationPrivate methodIList::InsertInfrastructure. For a description of this member, see Insert.
Explicit interface implemetationPrivate propertyIList::IsFixedSizeInfrastructure. For a description of this member, see IsFixedSize.
Explicit interface implemetationPrivate propertyIList::ItemInfrastructure. For a description of this member, see Item.
Explicit interface implemetationPrivate methodIList::RemoveInfrastructure. For a description of this member, see Remove.
Explicit interface implemetationPrivate propertyIStateManager::IsTrackingViewStateInfrastructure. For a description of this member, see IsTrackingViewState.
Explicit interface implemetationPrivate methodIStateManager::LoadViewStateInfrastructure. Loads the previously saved state.
Explicit interface implemetationPrivate methodIStateManager::SaveViewStateInfrastructure. Returns object containing state changes.
Explicit interface implemetationPrivate methodIStateManager::TrackViewStateInfrastructure. Starts tracking state of changes.
Top

The ListItemCollection class represents a collection of ListItem objects. The ListItem objects, in turn, represent the items displayed in list controls, such as the ListBox. To programmatically retrieve ListItem objects from a list control, use one of following methods:

  • Use the indexer to get a single ListItem from the collection, using array notation.

  • Use the CopyTo method to copy the contents of the collection to a System::Array object, which can then be used to get items from the collection.

  • Use the GetEnumerator method to create a System.Collections::IEnumerator implemented object, which can then be used to get items from the collection.

  • Use foreach (C#) or For Each (Visual Basic) to iterate through the collection.

The Count property specifies the total number of items in the collection, and is commonly used to determine the upper bound of the collection. You can add and remove items from the collection by using the Add and Remove methods.

The following code example demonstrates creating ListItemCollection objects, adding items to the collections, and removing items from the collections. In the example, the ListItemCollection named listBoxData is used as the data source for a ListBox control called ListBox1, and the ListItemCollection called ddBoxData is used as the data source for a DropDownList control called DropDownList1.

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

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

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

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Show:
© 2014 Microsoft