ListView.CreateChildControls Method (IEnumerable, Boolean)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com 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)

abstract CreateChildControls : 
        dataSource:IEnumerable *
        dataBinding:bool -> int
override CreateChildControls : 
        dataSource:IEnumerable *
        dataBinding:bool -> int

Parameters

dataSource
Type: System.Collections.IEnumerable

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

dataBinding
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
InvalidOperationException

dataSource returns null for DataSourceView.

-or-

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

-or-

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

-or-

The ListView control does not have a group placeholder specified.

-or-

The ListView control does not have an item placeholder specified.

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

System_CAPS_noteNote

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

.NET Framework
Available since 3.5
Return to top
Show: