ListItemCollection Class
TOC
Collapse the table of content
Expand the table of content

ListItemCollection Class

 

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

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

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

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

NameDescription
System_CAPS_pubmethodListItemCollection()

Initializes a new instance of the ListItemCollection class.

NameDescription
System_CAPS_pubpropertyCapacity

Gets or sets the maximum number of items that the ListItemCollection can store.

System_CAPS_pubpropertyCount

Gets the number of ListItem objects in the collection.

System_CAPS_pubpropertyIsReadOnly

Gets a value indicating whether the ListItemCollection is read-only.

System_CAPS_pubpropertyIsSynchronized

Gets a value indicating whether access to the ListItemCollection is synchronized (thread-safe).

System_CAPS_pubpropertyItem[Int32]

Gets a ListItem at the specified index in the collection.

System_CAPS_pubpropertySyncRoot

Gets the object that can be used to synchronize access to the ListItemCollection.

NameDescription
System_CAPS_pubmethodAdd(ListItem^)

Appends the specified ListItem to the end of the collection.

System_CAPS_pubmethodAdd(String^)

Appends a ListItem to the end of the collection that represents the specified string.

System_CAPS_pubmethodAddRange(array<ListItem^>^)

Adds the items in an array of ListItem objects to the collection.

System_CAPS_pubmethodClear()

Removes all ListItem objects from the collection.

System_CAPS_pubmethodContains(ListItem^)

Determines whether the collection contains the specified item.

System_CAPS_pubmethodCopyTo(Array^, Int32)

Copies the items from the ListItemCollection to the specified System::Array, starting with the specified index.

System_CAPS_pubmethodEquals(Object^)

Determines whether the specified object is equal to the current object.(Inherited from Object.)

System_CAPS_pubmethodFindByText(String^)

Searches the collection for a ListItem with a Text property that equals the specified text.

System_CAPS_pubmethodFindByValue(String^)

Searches the collection for a ListItem with a Value property that contains the specified value.

System_CAPS_pubmethodGetEnumerator()

Returns a System.Collections::IEnumerator implemented object that contains all ListItem objects in the ListItemCollection.

System_CAPS_pubmethodGetHashCode()

Serves as the default hash function. (Inherited from Object.)

System_CAPS_pubmethodGetType()

Gets the Type of the current instance.(Inherited from Object.)

System_CAPS_pubmethodIndexOf(ListItem^)

Determines the index value that represents the position of the specified ListItem in the collection.

System_CAPS_pubmethodInsert(Int32, ListItem^)

Inserts the specified ListItem in the collection at the specified index location.

System_CAPS_pubmethodInsert(Int32, String^)

Inserts a ListItem which represents the specified string in the collection at the specified index location.

System_CAPS_pubmethodRemove(ListItem^)

Removes the specified ListItem from the collection.

System_CAPS_pubmethodRemove(String^)

Removes a ListItem from the collection that represents the specified string.

System_CAPS_pubmethodRemoveAt(Int32)

Removes the ListItem at the specified index from the collection.

System_CAPS_pubmethodToString()

Returns a string that represents the current object.(Inherited from Object.)

NameDescription
System_CAPS_pubinterfaceSystem_CAPS_privmethodIList::Add(Object^)

This API supports the product infrastructure and is not intended to be used directly from your code. For a description of this member, see Add.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList::Contains(Object^)

This API supports the product infrastructure and is not intended to be used directly from your code. For a description of this member, see Contains.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList::IndexOf(Object^)

This API supports the product infrastructure and is not intended to be used directly from your code. For a description of this member, see IndexOf.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList::Insert(Int32, Object^)

This API supports the product infrastructure and is not intended to be used directly from your code. For a description of this member, see Insert.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList::Remove(Object^)

This API supports the product infrastructure and is not intended to be used directly from your code. For a description of this member, see Remove.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager::LoadViewState(Object^)

This API supports the product infrastructure and is not intended to be used directly from your code. Loads the previously saved state.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager::SaveViewState()

This API supports the product infrastructure and is not intended to be used directly from your code. Returns object containing state changes.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager::TrackViewState()

This API supports the product infrastructure and is not intended to be used directly from your code. Starts tracking state of changes.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIList::IsFixedSize

This API supports the product infrastructure and is not intended to be used directly from your code. For a description of this member, see IsFixedSize.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIList::Item[Int32]

This API supports the product infrastructure and is not intended to be used directly from your code. For a description of this member, see Item.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIStateManager::IsTrackingViewState

This API supports the product infrastructure and is not intended to be used directly from your code. For a description of this member, see IsTrackingViewState.

NameDescription
System_CAPS_pubmethodAsParallel()

Overloaded. Enables parallelization of a query.(Defined by ParallelEnumerable.)

System_CAPS_pubmethodAsQueryable()

Overloaded. Converts an IEnumerable to an IQueryable.(Defined by Queryable.)

System_CAPS_pubmethodCast<TResult>()

Casts the elements of an IEnumerable to the specified type.(Defined by Enumerable.)

System_CAPS_pubmethodOfType<TResult>()

Filters the elements of an IEnumerable based on a specified type.(Defined by Enumerable.)

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
Available since 1.1

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

Return to top
Show:
© 2016 Microsoft