BaseDataBoundControl.OnDataPropertyChanged 方法

定義

命名空間:

System.Web.UI.WebControls

組件:

System.Web.dll

其中一個基底資料來源識別屬性變更之後，將資料繫結控制項重新繫結至其資料。

protected:
 virtual void OnDataPropertyChanged();

protected virtual void OnDataPropertyChanged ();

abstract member OnDataPropertyChanged : unit -> unit
override this.OnDataPropertyChanged : unit -> unit

Protected Overridable Sub OnDataPropertyChanged ()

例外狀況

HttpException

嘗試在控制項的資料繫結 (Data Binding) 階段變更此屬性值。

範例

下列程式碼範例顯示屬於衍生資料繫結控制項類別的屬性。 此範例示範當識別資料來源的屬性在初始化資料繫結控制項之後變更時，資料繫結控制項如何呼叫 OnDataPropertyChanged 方法。 此程式碼範例是提供給 類別之較大範例的 DataBoundControl 一部分。

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

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

備註

OnDataPropertyChanged當 、 DataSourceID 或 DataMember 屬性值在發生頁面 PreRender 事件之後的任何時間變更時 DataSource ，就會呼叫 方法。

另請參閱

• Initialized
• DataSource
• DataSourceID