定義自訂元件屬性和引發 PropertyChanged 事件

更新:2007 年 11 月

在建立用戶端元件類別時,可以定義您認為網頁開發人員會存取的屬性。您也可以在元件屬性的 set 存取子中引發 Sys.Component.propertyChanged 通知事件。使用元件的網頁開發人員可以將屬性通知事件繫結至自己的處理常式,每當屬性值變更時就執行程式碼。

在自訂用戶端元件中定義公用屬性

在 ASP.NET AJAX用戶端元件中,屬性存取子定義為類別原型的方法。存取子方法以 get_ 和 set_ 前置詞接著屬性名稱來命名。下列範例顯示如何在類別原型中定義名為 interval 的讀寫屬性。

get_interval: function() {
    return this._interval;
},
set_interval: function(value) {
    this._interval = value;
}

引發 PropertyChanged 事件

您可以在屬性 set 存取子中叫用 Sys.Component raisePropertyChanged 方法,以引發 propertyChanged 事件。您的元件繼承 Sys.ComponentSys.UI.BehaviorSys.UI.Control 基底類別的 raisePropertyChanged 方法。

下列範例顯示如何在設定 interval 屬性時引發 propertyChanged 事件。

get_interval: function() {
    return this._interval;
},
set_interval: function(value) {
    if (this._interval !== value) {
        this._interval = value;
        this.raisePropertyChanged('interval');
    }
}

如需如何引發和處理自訂元件的 propertyChanged 事件的範例,請參閱建立自訂的隱藏式用戶端元件。如需 raisePropertyChanged 方法的詳細資訊,請參閱 Sys.Component.raisePropertyChanged 方法

請參閱

工作

建立自訂的隱藏式用戶端元件

概念

使用原型模型建立用戶端元件類別