DataListItemCollection Class

.NET Framework (current version)

Other Versions

Represents the collection of DataListItem objects in the DataList control. This class cannot be inherited.

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

Inheritance Hierarchy

System::Object
System.Web.UI.WebControls::DataListItemCollection

Syntax

C++

public ref class DataListItemCollection sealed : ICollection, 
	IEnumerable

Constructors

	Name	Description
	DataListItemCollection(ArrayList^)	Initializes a new instance of the DataListItemCollection class.

Properties

	Name	Description
	Count	Gets the number of DataListItem objects in the collection.
	IsReadOnly	Gets a value that indicates whether the DataListItem objects in the DataListItemCollection can be modified.
	IsSynchronized	Gets a value indicating whether access to the DataListItemCollection is synchronized (thread-safe).
	Item[Int32]	Gets a DataListItem object at the specified index in the collection.
	SyncRoot	Gets the object that can be used to synchronize access to the DataListItemCollection collection.

Methods

	Name	Description
	CopyTo(Array^, Int32)	Copies all the items from this DataListItemCollection collection to the specified System::Array object, starting at the specified index in the System::Array object.
	Equals(Object^)	Determines whether the specified object is equal to the current object.(Inherited from Object.)
	GetEnumerator()	Returns a System.Collections::IEnumerator interface that contains all DataListItem objects in the DataListItemCollection.
	GetHashCode()	Serves as the default hash function. (Inherited from Object.)
	GetType()	Gets the Type of the current instance.(Inherited from Object.)
	ToString()	Returns a string that represents the current object.(Inherited from Object.)

Extension Methods

	Name	Description
	AsParallel()	Overloaded. Enables parallelization of a query.(Defined by ParallelEnumerable.)
	AsQueryable()	Overloaded. Converts an IEnumerable to an IQueryable.(Defined by Queryable.)
	Cast<TResult>()	Casts the elements of an IEnumerable to the specified type.(Defined by Enumerable.)
	OfType<TResult>()	Filters the elements of an IEnumerable based on a specified type.(Defined by Enumerable.)

The DataListItemCollection class represents a collection of DataListItem objects, which in turn represent the data items in a DataList control. To programmatically retrieve DataListItem objects from a DataList control, use one of the following methods:

Use the indexer to get a single DataListItem object 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 interface, which can then be used to get items from 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.

Examples

The following example creates a data source in the form of a DataView control and binds it to a DataList control declared in markup. It then displays the contents of the underlying DataListItemCollection object on the page.

C++

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

Version Information

.NET Framework
Available since 1.1

Thread Safety

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