CompositeDataBoundControl::CreateChildControls Method (IEnumerable^, Boolean)

.NET Framework (current version)

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)

Syntax

C++

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

Parameters

dataSource: Type: System.Collections::IEnumerable^
An IEnumerable that contains the values to bind to the control.

dataBinding: 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.

Examples

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

C++

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

Version Information

.NET Framework
Available since 2.0