This documentation is archived and is not being maintained.

CompositeDataBoundControl Class

Represents the base class for a tabular data-bound control that is composed of other server controls.

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

[AspNetHostingPermissionAttribute(SecurityAction::InheritanceDemand, Level = AspNetHostingPermissionLevel::Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction::LinkDemand, Level = AspNetHostingPermissionLevel::Minimal)]
public ref class CompositeDataBoundControl abstract : public DataBoundControl, 
	INamingContainer
<asp:CompositeDataBoundControl />

The CompositeDataBoundControl class serves as the base class for a composite server control that binds to data from a data source. A composite server control is a control that is built from a combination of other server controls. Page developers do not use the CompositeDataBoundControl class directly; instead, they use controls that derive from this class. Examples of composite data-bound controls include the DetailsView, FormView, and GridView controls.

Classes that inherit from the CompositeDataBoundControl control must override the CreateChildControls(IEnumerable, Boolean) method to create the control hierarchy. To access the child controls of a composite data-bound control, use the Controls collection.

Notes to Inheritors:

When you inherit from the CompositeDataBoundControl class, you must override the following member: CreateChildControls(IEnumerable, Boolean).

The following code example demonstrates how to create a custom composite data-bound control that displays the values of a data source in a table.

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

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

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

.NET Framework

Supported in: 3.5, 3.0, 2.0
Show: