HyperLinkDataBindingHandler.DataBindControl Method (IDesignerHost, Control)

 

Resolves design-time data-binding for the specified control.

Namespace:   System.Web.UI.Design
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

.NET Framework
Available since 1.1
Return to top
Show: