Definir propiedades de componentes personalizados y provocar eventos PropertyChanged

Actualización: noviembre 2007

Al crear una clase de componente de cliente, define las propiedades a las que espera que los desarrolladores de páginas obtengan acceso. También puede provocar eventos de notificación Sys.Component.propertyChanged en los descriptores de acceso set de las propiedades del componente. Los desarrolladores de páginas que utilicen el componente pueden enlazar el evento de notificación de propiedad a su propio controlador para ejecutar código cuando cambie el valor de la propiedad.

Definir propiedades públicas en un componente de cliente personalizado

En componentes de cliente AJAX de ASP.NET, los descriptores de acceso de la propiedad se definen como métodos del prototipo de clase. Los métodos de descriptor de acceso se denominan con los prefijos get_ y set_ seguidos del nombre de la propiedad. El ejemplo siguiente muestra cómo definir una propiedad de lectura y escritura denominada interval en el prototipo de clase.

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

Provocar un evento PropertyChanged

Puede invocar el método Sys.Component raisePropertyChanged en un descriptor de acceso set de la propiedad para provocar un evento propertyChanged. El componente hereda el método raisePropertyChanged de Sys.Component, Sys.UI.Behavior o de la clase base Sys.UI.Control.

El ejemplo siguiente muestra cómo provocar un evento propertyChanged para una propiedad interval cada vez que se establezca la propiedad.

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

Para obtener un ejemplo de cómo provocar y administrar un evento propertyChanged de un componente personalizado, vea Crear componentes de cliente no visuales personalizados. Para obtener más información sobre el método raisePropertyChanged, vea Sys.Component.raisePropertyChanged (Método).

Vea también

Tareas

Crear componentes de cliente no visuales personalizados

Conceptos

Crear una clase de componente de cliente utilizando el modelo de prototipo