HyperLinkDataBindingHandler.DataBindControl(IDesignerHost, Control) Methode

Definition

Namespace:

System.Web.UI.Design

Assembly:

System.Design.dll

Behebt die Entwurfszeitdatenbindung für das angegebene Steuerelement.

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

Das IDesignerHost Dokument, das das Steuerelement enthält.

control

Control

Die Control An-Datenbindung.

Beispiele

Im folgenden Codebeispiel wird eine Klasse mit dem Namen CustomHyperLinkDataBindingHandlererstellt, die von der HyperLinkDataBindingHandler Klasse abgeleitet wird. Die Entwurfszeitdatenbindung für die ImageUrl Eigenschaft der CustomHyperLink Klasse wird aufgelöst, 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 NavigateUrl und Eigenschaften 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 das Erscheinungsbild eines funktionierenden Hyperlinks aufweist.