CompositeDataBoundControl::CreateChildControls Method (IEnumerable^, Boolean)


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

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)

virtual int CreateChildControls(
	IEnumerable^ dataSource,
	bool dataBinding
) abstract


Type: System.Collections::IEnumerable^

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

Type: System::Boolean

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

Return Value

Type: System::Int32

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.

.NET Framework
Available since 2.0
Return to top