Définition de propriétés de composants personnalisées et déclenchement d'événements PropertyChanged

Mise à jour : novembre 2007

Lorsque vous créez une classe Component, vous définissez les propriétés auxquels les développeurs de pages vont accéder. Vous pouvez également déclencher des événements de notification Sys.Component.propertyChanged dans les accesseurs set pour les propriétés de votre composant. Les développeurs de pages qui utilisent le composant peuvent lier l'événement de notification de propriété à leur propre gestionnaire pour exécuter le code lorsque la valeur de la propriété change.

Définition de propriétés publiques dans un composant client personnalisé

Dans les composants clients ASP.NET AJAX, les accesseurs de propriété sont définis comme méthodes du prototype de classe. Le nom des méthodes d'accesseur se compose du préfixe get_ ou set_, suivi du nom de la propriété. L'exemple suivant montre comment définir une propriété en lecture-écriture nommée interval dans le prototype de classe.

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

Déclenchement d'un événement PropertyChanged

Vous pouvez appeler la méthode raisePropertyChanged Sys.Component dans un accesseur de jeu de propriétés pour déclencher un événement propertyChanged. Votre composant hérite la méthode raisePropertyChanged du Sys.Component, Sys.UI.Behavior ou classe de base Sys.UI.Control.

L'exemple suivant illustre le déclenchement d'un événement propertyChanged pour une propriété interval chaque fois que la propriété est définie.

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

Pour obtenir un exemple de déclenchement et de gestion d'un événement de composant personnalisé propertyChanged, consultez Création de composants clients non visuels personnalisés. Pour plus d'informations sur la méthode raisePropertyChanged, consultez Sys.Component.raisePropertyChanged, méthode.

Voir aussi

Tâches

Création de composants clients non visuels personnalisés

Concepts

Création d'une classe Component cliente à l'aide du modèle de prototype