ListControlDataBindingHandler.DataBindControl Method (IDesignerHost, Control)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Performs data binding on the specified control.

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

Public Overrides Sub DataBindControl (
	designerHost As IDesignerHost,
	control As Control


Type: System.ComponentModel.Design.IDesignerHost

The IDesignerHost for the document that contains the 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 Overrides Sub DataBindControl( _
ByVal designerHost As IDesignerHost, _
ByVal control As Control)

    ' Create a reference, named dataSourceBinding,
    ' to the control's DataSource binding.
    Dim dataSourceBinding As DataBinding _
        = CType( _
        control, _

    ' If the binding exists, create a reference to the
    ' list control, clear its ListItemCollection, and then add
    ' an item to the collection.
    If Not (dataSourceBinding Is Nothing) Then
        Dim simpleControl As SimpleRadioButtonList = _
            CType(control, SimpleRadioButtonList)

        simpleControl.Items.Add("Data-bound Radio Button.")
    End If
End Sub ' DataBindControl

.NET Framework
Available since 1.1
Return to top