ListView.CreateChildControls Method (IEnumerable, Boolean)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Creates the control hierarchy that is used to render the ListView control by using the specified data source.

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

Protected Overridable Function CreateChildControls (
	dataSource As IEnumerable,
	dataBinding As Boolean
) As Integer


Type: System.Collections.IEnumerable

An object that contains the data source for the ListView control.

Type: System.Boolean

true to indicate that the child controls are bound to data; false to indicate that the control will re-create itself from view state during a postback.

Return Value

Type: System.Int32

The number of items that are created.

Exception Condition

dataSource returns null for DataSourceView.


dataSource does not implement the ICollection interface and cannot return a TotalRowCount value.


dataSource does not implement the ICollection interface and dataBinding is set to false.


The ListView control does not have a group placeholder specified.


The ListView control does not have an item placeholder specified.

The CreateChildControls method is used to create the control hierarchy of the ListView control.


This method is primarily used by control developers to extend the ListView control.

.NET Framework
Available since 3.5
Return to top