HyperLinkDataBindingHandler.DataBindControl-Methode

Artikel
08/20/2007

Löst die Datenbindung zur Entwurfszeit für das angegebene Steuerelement auf.

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

Syntax

'Declaration
Public Overrides Sub DataBindControl ( _
    designerHost As IDesignerHost, _
    control As Control _
)
'Usage
Dim instance As HyperLinkDataBindingHandler
Dim designerHost As IDesignerHost
Dim control As Control

instance.DataBindControl(designerHost, control)

public override void DataBindControl (
    IDesignerHost designerHost,
    Control control
)

public:
virtual void DataBindControl (
    IDesignerHost^ designerHost, 
    Control^ control
) override

public void DataBindControl (
    IDesignerHost designerHost, 
    Control control
)

public override function DataBindControl (
    designerHost : IDesignerHost, 
    control : Control
)

Parameter

designerHost
Der IDesignerHost für das Dokument mit dem Steuerelement.

control
Das Control, das an Daten gebunden werden soll.

Hinweise

Diese Methode bestimmt, ob die Eigenschaften Text und href des HyperLink-Steuerelements an Daten gebunden sind. Wenn die Text-Eigenschaft datengebunden ist, wird der Wert der Eigenschaft durch diese Methode auf "DataBound" festgelegt. Wenn die href-Eigenschaft datengebunden ist, legt diese Methode den Wert der Eigenschaft auf eine Textzeichenfolge fest, sodass das Steuerelement wie ein funktionierender Hyperlink dargestellt wird.

Beispiel

Im folgenden Codebeispiel wird die Klasse CustomHyperLinkDataBindingHandler erstellt, die von der HyperLinkDataBindingHandler-Klasse abgeleitet ist. Für die ImageUrl-Eigenschaft der CustomHyperLink-Klasse wird die Datenbindung zur Entwurfszeit aufgelöst, sodass für die Eigenschaft Platzhaltertext angezeigt, wenn sie zur Entwurfszeit datengebunden ist.

' 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

// Derive a class from the HyperLinkDataBindingHandler. It will 
// resolve  data binding for the CustomHyperlink at design time.
public class CustomHyperLinkDataBindingHandler : 
    HyperLinkDataBindingHandler
{
    // Override the DataBindControl to set property values in  
    // the DataBindingCollection at design time.
    public override void DataBindControl(IDesignerHost designerHost, 
        Control control)
    {
        DataBindingCollection bindings = 
            ((IDataBindingsAccessor)control).DataBindings;
        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

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter .

Plattformen

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

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

HyperLinkDataBindingHandler-Klasse
HyperLinkDataBindingHandler-Member
System.Web.UI.Design-Namespace

Freigeben über