Definindo Propriedades de Componente Personalizadas e Disparando Eventos PropertyChanged

Quando você cria uma classe componente cliente, você define as propriedades que você espera que os desenvolvedores da página tenham acesso.Você também pode disparar eventos de notificação Sys.Component.propertyChanged no acessadores set de propriedades do seu componente.Desenvolvedores de página que usam o componente podem vincular o evento de notificação de propriedades para seus próprios manipuladores para executar o código quando o valor da propriedade é alterado.

Definindo Propriedades Públicas em um Componente Cliente personalizado

No ASP.NET AJAX componentes do cliente, sistema autônomo acessadores de propriedade são definidos sistema autônomo métodos de protótipo de classe. Os métodos acessadores são nomeados com prefixos get_ e set_ seguidos pelo nome da propriedade.O exemplo a seguir mostra como definir uma propriedade de leitura-gravação chamada interval no protótipo de classe.

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

Disparando um Evento PropertyChanged

Você pode chamar o método Sys.Component raisePropertyChanged em um acessador set de propriedade para disparar um evento propertyChanged.O componente herda o método raisePropertyChanged da classe base Sys.Component, Sys.UI.Behavior ou Sys.UI.Control.

O exemplo a seguir mostra como disparar um evento propertyChanged para uma propriedade interval sempre que a propriedade é definida.

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

Para obter um exemplo de como disparar e manipular um evento propertyChanged de um componente personalizado, consulte Criando Componentes Não Visual de Cliente personalizados.Para mais informações sobre o método raisePropertyChanged, consulte Método Sys.componente.raisePropertyChanged.

Consulte também

Tarefas

Criando Componentes Não Visual de Cliente personalizados

Conceitos

Criando uma Classe de Componente de Cliente Usando o Modelo Protótipo