This documentation is archived and is not being maintained.

ListControlDataBindingHandler.DataBindControl Method

Performs data binding on the specified control.

Namespace: System.Web.UI.Design.WebControls
Assembly: System.Design (in

public override void DataBindControl (
	IDesignerHost designerHost,
	Control control
public void DataBindControl (
	IDesignerHost designerHost, 
	Control control
public override function DataBindControl (
	designerHost : IDesignerHost, 
	control : Control
Not applicable.



The IDesignerHost for the document that contains the control.


The Control to bind.

If the ListControl control that is specified by control has a data source specified within its DataBindings property, the DataBindControl method clears the Items collection of the ListControl, and then adds a string message indicating that the ListControl is data bound to the Items collection.

The following code example shows how to override the DataBindControl method to add a string message to the associated SimpleRadioButtonList control when that control is data bound.

This code example is part of a larger example provided for the ListControlDataBindingHandler class.

// Override the DataBindControl. 
public override void DataBindControl(IDesignerHost designerHost, 
    Control control)
    // Create a reference, named dataSourceBinding, 
    // to the control DataSource binding.
    DataBinding dataSourceBinding = 

    // If the binding exists, create a reference to the
    // list control, clear its ListItemCollection, and then add
    // an item to the collection.
    if (! (dataSourceBinding == null))
        SimpleRadioButtonList simpleControl = 

        simpleControl.Items.Add("Data-bound Radio Button.");
} // DataBindControl

Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0