This documentation is archived and is not being maintained.

GridView.CreateChildControls Method (IEnumerable, Boolean)

This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.

Creates the control hierarchy used to render the GridView control using the specified data source.

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

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


Type: System.Collections.IEnumerable
An System.Collections.IEnumerable that contains the data source for the GridView control.
Type: System.Boolean
true to indicate that the child controls are bound to data; otherwise, false.

Return Value

Type: System.Int32
The number of rows created.


dataSource returns a null DataSourceView.


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


AllowPaging is true and dataSource does not implement the ICollection interface and cannot perform data source paging.


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

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


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

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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