HyperLinkDataBindingHandler.DataBindControl(IDesignerHost, Control) Methode

Definition

Namespace:

System.Web.UI.Design

Assembly:

System.Design.dll

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

public:
 override void DataBindControl(System::ComponentModel::Design::IDesignerHost ^ designerHost, System::Web::UI::Control ^ control);

public override void DataBindControl (System.ComponentModel.Design.IDesignerHost designerHost, System.Web.UI.Control control);

override this.DataBindControl : System.ComponentModel.Design.IDesignerHost * System.Web.UI.Control -> unit

Public Overrides Sub DataBindControl (designerHost As IDesignerHost, control As Control)

Parameter

designerHost

IDesignerHost

Der IDesignerHost für das Dokument mit dem Steuerelement.

control

Control

Das Control, das an Daten gebunden werden soll.

Beispiele

Im folgenden Codebeispiel wird eine Klasse mit dem Namen CustomHyperLinkDataBindingHandlererstellt, die von der HyperLinkDataBindingHandler -Klasse abgeleitet wird. Es löst die Entwurfszeitdatenbindung für die ImageUrl Eigenschaft der CustomHyperLink -Klasse auf, sodass Platzhaltertext für die Eigenschaft angezeigt wird, 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 : 
    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

' 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
End Class

Hinweise

Diese Methode bestimmt, ob die Text Eigenschaften und NavigateUrl des HyperLink Steuerelements datengebunden sind. Wenn die Text Eigenschaft datengebunden ist, legt diese Methode den Wert der Eigenschaft auf "DataBound" fest. Wenn die NavigateUrl Eigenschaft datengebunden ist, legt diese Methode den Wert der Eigenschaft auf eine Textzeichenfolge fest, sodass das Steuerelement die Darstellung eines funktionierenden Hyperlinks hat.