CompositeDataBoundControl.CreateChildControls Method (IEnumerable, Boolean)

Note: This method is new in the .NET Framework version 2.0.

When overridden in an abstract class, creates the control hierarchy that is used to render the composite data-bound control based on the values from the specified data source.

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

protected:
virtual int CreateChildControls (
	IEnumerable^ dataSource, 
	bool dataBinding
) abstract
protected abstract int CreateChildControls (
	IEnumerable dataSource, 
	boolean dataBinding
)
protected abstract function CreateChildControls (
	dataSource : IEnumerable, 
	dataBinding : boolean
) : int

Parameters

dataSource

An IEnumerable that contains the values to bind to the control.

dataBinding

true to indicate that the CreateChildControls(IEnumerable,Boolean) is called during data binding; otherwise, false.

Return Value

The number of items created by the CreateChildControls(IEnumerable,Boolean).

The CreateChildControls method is a helper method that is used by classes that derive from the CompositeDataBoundControl class to create the control hierarchy for a composite data-bound control. When extending the CompositeDataBoundControl class, you must override the CreateChildControls method to create your own control hierarchy. For more information on creating a composite control, see Developing Custom ASP.NET Server Controls.

The following code example demonstrates how to override the CreateChildControls(IEnumerable,Boolean) method in a custom control to create the control hierarchy.

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

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

.NET Framework

Supported in: 2.0

Community Additions

ADD
Show: