This documentation is archived and is not being maintained.

DataBoundControlAdapter::PerformDataBinding Method

Binds the data in the data source of the associated DataBoundControl object to the control adapter.

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

protected public:
virtual void PerformDataBinding(
	IEnumerable^ data
)

Parameters

data
Type: System.Collections::IEnumerable
An IEnumerable of Object to be bound to the derived DataBoundControl.

The PerformDataBinding method is called in place of the DataBoundControl::PerformDataBinding method when a DataBoundControlAdapter control adapter is attached to a control derived from the DataBoundControl class.

Typically, an override of DataBoundControl::PerformDataBinding iterates through data, creating distinct names and values when necessary, and saves it to an internal collection. Usually, RenderContents or a similar method of the DataBoundControl will populate the user interface or child controls from that internal collection.

Notes to Inheritors

Override the PerformDataBinding method when specialized binding logic is required for the target browser—for example, when item names must be constructed differently than for the general usage of the control.

The PerformDataBinding base method calls DataBoundControl::PerformDataBinding. You should call the PerformDataBinding base method only if you require the data binding functionality of the DataBoundControl.

The following code example shows how to override the PerformDataBinding collection to save the data source to a one-dimensional ArrayList object and add row separators. It also shows how to override the RenderContents method to render the ArrayList as a list of fields separated by <br /> tags.

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

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