ListControlDataBindingHandler.DataBindControl Method (IDesignerHost, Control)

 

Performs data binding on the specified control.

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

public override void DataBindControl(
	IDesignerHost designerHost,
	Control control
)

Parameters

designerHost
Type: System.ComponentModel.Design.IDesignerHost

The IDesignerHost for the document that contains the control.

control
Type: System.Web.UI.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 = 
        ((IDataBindingsAccessor)control).DataBindings["DataSource"];

    // 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 = 
            (SimpleRadioButtonList)control;

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

.NET Framework
Available since 1.1
Return to top
Show: