HierarchicalDataBoundControl.OnDataPropertyChanged メソッドとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

HierarchicalDataBoundControl.OnDataPropertyChanged メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

基本データソースの識別プロパティが変更された場合に、データバインドコントロールをデータに再バインドするために呼び出されます。

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

Visual Basic (宣言)

Protected Overrides Sub
 OnDataPropertyChanged

Visual Basic (使用法)

Me.OnDataPropertyChanged

protected override void OnDataPropertyChanged
 ()

C++

protected:
virtual void OnDataPropertyChanged () override

protected void OnDataPropertyChanged ()

JScript

protected override function OnDataPropertyChanged
 ()

解説

OnDataPropertyChanged メソッドは、ページの PreRender イベントの発生後、DataSource または DataSourceID が変更された場合に呼び出されます。

使用例

次のコード例は、データバインドコントロールの初期化後、データソースを識別するプロパティが変更された場合に、データバインドコントロールから OnDataPropertyChanged メソッドを呼び出す方法を示しています。このコード例は、HierarchicalDataBoundControl クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

Public Property DataTextField() As
 String
    Get
        Dim o As Object
 = ViewState("DataTextField")
        If o Is Nothing
 Then
            Return String.Empty
        Else
            Return CStr(o)
        End If
    End Get
    Set(ByVal value As String)
        ViewState("DataTextField") = value
        If Initialized Then
            OnDataPropertyChanged()
        End If
    End Set
End Property

public string DataTextField {
    get {
        object o = ViewState["DataTextField"];
        return((o == null) ? string.Empty
 : (string)o);
    }
    set {
        ViewState["DataTextField"] = value;
        if (Initialized) {
            OnDataPropertyChanged();
        }
    }
}