HyperLinkDataBindingHandler.DataBindControl メソッド

.NET Framework クラス ライブラリ リファレンス

HyperLinkDataBindingHandler.DataBindControl メソッド

指定したコントロールのデザイン時のデータ バインディングを解決します。

名前空間: System.Web.UI.Design
アセンブリ: System.Design (system.design.dll 内)
構文

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As HyperLinkDataBindingHandler
Dim designerHost As IDesignerHost
Dim control As Control

instance.DataBindControl(designerHost, control)

C#

public override void DataBindControl (
    IDesignerHost designerHost,
    Control control
)

C++

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

J#

public void DataBindControl (
    IDesignerHost designerHost, 
    Control control
)

JScript

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

パラメータ

designerHost

コントロールを含んでいるドキュメントの IDesignerHost。

control

データ連結する Control。

解説

このメソッドは、HyperLink コントロールの Text プロパティと NavigateUrl プロパティがデータ連結されているかどうかを確認します。Text プロパティがデータ連結されている場合、このメソッドはプロパティの値を "DataBound" に設定します。NavigateUrl プロパティがデータ連結されている場合、このメソッドはプロパティの値をテキスト文字列に設定して、コントロールに有効なハイパーリンクのような外観を持たせます。

使用例

HyperLinkDataBindingHandler クラスから派生する CustomHyperLinkDataBindingHandler という名前のクラスを作成するコードの例を次に示します。このコードは、CustomHyperLink クラスの ImageUrl プロパティのデザイン時のデータ連結を解決します。これにより、このクラスがデザイン時にデータ連結された場合にこのプロパティのプレースホルダ テキストが表示されます。

Visual Basic

' 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

C#

// 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 のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
HyperLinkDataBindingHandler クラス
HyperLinkDataBindingHandler メンバ
System.Web.UI.Design 名前空間