Export (0) Print
Expand All

ListControlDataBindingHandler.DataBindControl Method

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

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, 1.1, 1.0

Community Additions

ADD
Show:
© 2014 Microsoft