DataBindControl Method
Collapse the table of content
Expand the table of content

HyperLinkDataBindingHandler.DataBindControl Method

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

Namespace: System.Web.UI.Design
Assembly: System.Design (in

public override void DataBindControl (
	IDesignerHost designerHost,
	Control control
public void DataBindControl (
	IDesignerHost designerHost, 
	Control control
public override function DataBindControl (
	designerHost : IDesignerHost, 
	control : Control
Not applicable.



The IDesignerHost for the document that contains the 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 : 
    // Override the DataBindControl to set property values in  
    // the DataBindingCollection at design time.
    public override void DataBindControl(IDesignerHost designerHost, 
        Control control)
        DataBindingCollection bindings = 
        DataBinding imageBinding = bindings["ImageUrl"];

           // If Text is empty, supply a default value.
        if (!(imageBinding == null))
            CustomHyperLink hype = (CustomHyperLink)control;
            hype.ImageUrl = "Image URL.";

        // Call the base method to bind the control.
        base.DataBindControl(designerHost, control);
    } // DataBindControl
} // CustomHyperLinkDataBindingHandler

Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

Community Additions

© 2015 Microsoft