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 internal 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.

// One-dimensional list for the grid data.
ArrayList dataArray = new ArrayList();

// Copy grid data to one-dimensional list, add row separators. 
protected override void PerformDataBinding(IEnumerable data)
{
    IEnumerator dataSourceEnumerator = data.GetEnumerator();

    // Iterate through the table rows. 
    while (dataSourceEnumerator.MoveNext())
    {
        // Add the next data row to the ArrayList.
        dataArray.AddRange(
            ((DataRowView)dataSourceEnumerator.Current).Row.ItemArray);

        // Add a separator to the ArrayList.
        dataArray.Add("----------");
    }
}

// Render the data source as a one-dimensional list. 
protected override void RenderContents(
    System.Web.UI.HtmlTextWriter writer)
{
    // Render the data list. 
    for( int col=0; col<dataArray.Count;col++)
    {
        writer.Write(dataArray[col]);
        writer.WriteBreak();
    }
}

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: