Definizione di proprietà del componente personalizzato e generazione di eventi PropertyChanged

Aggiornamento: novembre 2007

Quando si crea una classe del componente client, si definiscono le proprietà a cui accederanno gli sviluppatori della pagina. È inoltre possibile generare eventi di notifica Sys.Component.propertyChanged nelle funzioni di accesso set per le proprietà del componente. Gli sviluppatori della pagina che utilizzano il componente possono associare l'evento di notifica delle proprietà a un gestore specifico in modo da eseguire il codice quando viene modificato il valore delle proprietà.

Definizione di proprietà pubbliche in un componente client personalizzato

Nei componenti client ASP.NET AJAX°le funzioni di accesso delle proprietà vengono definite come metodi del prototipo di classe. I metodi delle funzioni di accesso°vengono denominati con i prefissi get_ e set_ seguiti dal nome della proprietà. Nell'esempio riportato di seguito viene illustrato come definire una proprietà di lettura e scrittura denominata interval°nel prototipo di classe.

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

Generazione di un evento PropertyChanged

È possibile richiamare il metodo Sys.Component raisePropertyChanged in una funzione di accesso set della proprietà per generare un evento propertyChanged. Il componente eredita il metodo raisePropertyChanged dalla classe di base Sys.Component, Sys.UI.Behavior o Sys.UI.Control.

Nell'esempio seguente viene illustrato come generare un evento propertyChanged per una proprietà interval ogni volta che viene impostata la proprietà.

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

Per un esempio di come generare e gestire un evento propertyChanged del componente personalizzato, vedere Creazione di componenti client non visivi personalizzati. Per ulteriori informazioni sul metodo raisePropertyChanged, vedere Metodo Sys.Component.raisePropertyChanged.

Vedere anche

Attività

Creazione di componenti client non visivi personalizzati

Concetti

Creazione di una classe Component del client tramite il modello di prototipo