ListControlDataBindingHandler Class
Assembly: System.Design (in system.design.dll)
The ListControlDataBindingHandler class performs design-time data binding of a ListControl control. The ListControlDataBindingHandler class is referenced by the ListControl using the DataBindingHandlerAttribute class.
The DataBindControl method performs the design-time data binding.
This section contains two code examples. The first one demonstrates how to derive a control from the RadioButtonList control and associate it with its data binding handler. The second one demonstrates how to the derive a class from the ListControlDataBindingHandler class.
The following code example shows how to derive the SimpleRadioButtonList control from the RadioButtonList control, and then apply the DataBindingHandlerAttribute attribute to associate the SimpleRadioButtonList control with its data binding handler, the SimpleRadioButtonListDataBindingHandler class.
Imports System.Web Imports System.Web.UI Imports System.Web.UI.WebControls Imports System.ComponentModel Imports System.Security.Permissions Namespace Examples.VB.WebControls.Design ' The SimpleRadioButtonList is a copy of the RadioButtonList. ' It uses the SimpleRadioButtonListDesigner for design-time support. <AspNetHostingPermission(SecurityAction.Demand, _ Level:=AspNetHostingPermissionLevel.Minimal)> _ <AspNetHostingPermission(SecurityAction.InheritanceDemand, _ Level:=AspNetHostingPermissionLevel.Minimal)> _ <DesignerAttribute(GetType(Examples.VB.WebControls.Design. _ SimpleRadioButtonListDesigner))> _ <DataBindingHandler(GetType(Examples.VB.WebControls.Design. _ SimpleRadioButtonListDataBindingHandler))> _ Public Class SimpleRadioButtonList Inherits RadioButtonList End Class ' SimpleRadioButtonList End Namespace ' Examples.VB.WebControls.Design
The following code example shows how to derive the SimpleRadioButtonListDataBindingHandler class from the ListControlDataBindingHandler class. It overrides the DataBindControl method to add a message to the associated SimpleRadioButtonList control when that control is data bound.
' Imports System.Design Imports System Imports System.ComponentModel Imports System.ComponentModel.Design Imports System.Web.UI Imports System.Web.UI.Design.WebControls Namespace Examples.VB.WebControls.Design ' Derive the SimpleRadioButtonListDataBindingHandler. Public Class SimpleRadioButtonListDataBindingHandler Inherits ListControlDataBindingHandler ' 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, _ IDataBindingsAccessor).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 Not (dataSourceBinding Is Nothing) Then Dim simpleControl As SimpleRadioButtonList = _ CType(control, SimpleRadioButtonList) simpleControl.Items.Clear() simpleControl.Items.Add("Data-bound Radio Button.") End If End Sub ' DataBindControl End Class ' SimpleRadioButtonListDataBindingHandler End Namespace ' Examples.VB.WebControls.Design
- SecurityPermission for calling unmanaged code. Demand value: Demand. Permission value: UnmanagedCode
System.Web.UI.Design.DataBindingHandler
System.Web.UI.Design.WebControls.ListControlDataBindingHandler
Reference
ListControlDataBindingHandler MembersSystem.Web.UI.Design.WebControls Namespace
ListControl
ListControlDesigner
DataBindingHandler
DataBindingHandlerAttribute
Other Resources
Introduction to ASP.NET Control DesignersWalkthrough: Creating a Basic Control Designer for a Web Server Control
Extending Design-Time Support
How to: Extend the Appearance and Behavior of Controls in Design Mode