BaseDataBoundControl.OnDataPropertyChanged メソッド

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

BaseDataBoundControl.OnDataPropertyChanged メソッド

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

基本データ ソースの識別プロパティの 1 つが変更された後、データ バインド コントロールをデータに再バインドします。

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

Visual Basic (宣言)

Protected Overridable Sub
 OnDataPropertyChanged

Visual Basic (使用法)

Me.OnDataPropertyChanged

C#

protected virtual void OnDataPropertyChanged
 ()

C++

protected:
virtual void OnDataPropertyChanged ()

J#

protected void OnDataPropertyChanged ()

JScript

protected function OnDataPropertyChanged ()

解説

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

使用例

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

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

C#

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

プラットフォーム

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

参照

関連項目
BaseDataBoundControl クラス
BaseDataBoundControl メンバ
System.Web.UI.WebControls 名前空間
Initialized
DataSource
DataSourceID