HyperLinkDataBindingHandler.DataBindControl Method (IDesignerHost, Control)
Resolves design-time data-binding for the specified control.
Assembly: System.Design (in System.Design.dll)
Public Overrides Sub DataBindControl ( designerHost As IDesignerHost, control As 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 data bind.
This method determines whether the Text and NavigateUrl properties of the HyperLink control are data-bound. If the Text property is data-bound, this method sets the value of the property to "DataBound". If the NavigateUrl property is data-bound, this method sets the value of the property to a text string so the control will have the appearance of a working hyperlink.
The following code example creates a class, named CustomHyperLinkDataBindingHandler, which derives from the HyperLinkDataBindingHandler class. It resolves design-time data binding for the ImageUrl property of the CustomHyperLink class so that placeholder text is displayed for the property when it is data-bound at design time.
' Derive a class from the HyperLinkDataBindingHandler. It will ' resolve data binding for the CustomHyperlink at design time. Public Class CustomHyperLinkDataBindingHandler Inherits HyperLinkDataBindingHandler ' Override the DataBindControl to set property values in ' the DataBindingCollection at design time. Public Overrides Sub DataBindControl( _ ByVal designerHost As IDesignerHost, ByVal control As Control) Dim bindings As DataBindingCollection = _ CType(control, IDataBindingsAccessor).DataBindings Dim imageBinding As DataBinding = bindings("ImageUrl") If Not (imageBinding Is Nothing) Then Dim hLink As CustomHyperLink = CType(control, CustomHyperLink) hLink.ImageUrl = "Image URL." End If MyBase.DataBindControl(designerHost, control) End Sub ' DataBindControl End Class ' CustomHyperLinkDataBindingHandler
Available since 1.1