FrameworkElement.OnPropertyChanged(DependencyPropertyChangedEventArgs) Método

Definição

Invocado sempre que o valor efetivo de qualquer propriedade de dependência nesse FrameworkElement for atualizada.Invoked whenever the effective value of any dependency property on this FrameworkElement has been updated. A propriedade de dependência específica alterada é relatada no parâmetro de argumentos.The specific dependency property that changed is reported in the arguments parameter. Substitui OnPropertyChanged(DependencyPropertyChangedEventArgs).Overrides OnPropertyChanged(DependencyPropertyChangedEventArgs).

protected:
 override void OnPropertyChanged(System::Windows::DependencyPropertyChangedEventArgs e);
protected override void OnPropertyChanged (System.Windows.DependencyPropertyChangedEventArgs e);
override this.OnPropertyChanged : System.Windows.DependencyPropertyChangedEventArgs -> unit
Protected Overrides Sub OnPropertyChanged (e As DependencyPropertyChangedEventArgs)

Parâmetros

e
DependencyPropertyChangedEventArgs

Os dados de evento que descrevem a propriedade alterada, bem como valores novos e antigos.The event data that describes the property that changed, as well as old and new values.

Comentários

Esse método não pretende geralmente detectar alterações ou invalidações de propriedade.This method is not intended to generally detect property changes or invalidations. Em vez disso, ele é destinado a modificações do padrão de invalidação geral se determinadas informações forem conhecidas sobre classificações amplas de propriedades.It is instead intended for modifications of the general invalidation pattern if certain information is known about wide classifications of properties.

Esse método é potencialmente invocado muitas vezes durante a vida útil de um objeto.This method is potentially invoked many times during the life of an object. Portanto, você pode obter um melhor desempenho se substituir os metadados de propriedades específicas e, em seguida, anexar CoerceValueCallback ou PropertyChangedCallback funções para propriedades individuais.Therefore, you can achieve better performance if you override the metadata of specific properties and then attach CoerceValueCallback or PropertyChangedCallback functions for individual properties. No entanto, você usaria esse método se uma FrameworkElement incluir um número significativo de propriedades de dependência de valor dependente ou se ela incluir lógica, como comportamento de renderização, que deve ser executada novamente por vários casos relacionados de invalidações de propriedade.However, you would use this method if a FrameworkElement includes a significant number of value-interrelated dependency properties, or if it includes logic such as rendering behavior that must be rerun for several related cases of property invalidations.

Observe que há um método de OnPropertyChanged de nome idêntico com uma assinatura diferente (o tipo de parâmetro é PropertyChangedEventArgs) que pode aparecer em várias classes.Note that there is an identically named OnPropertyChanged method with a different signature (the parameter type is PropertyChangedEventArgs) that can appear on a number of classes. Esse OnPropertyChanged é usado para notificações de objeto de dados e faz parte do contrato para INotifyPropertyChanged.That OnPropertyChanged is used for data object notifications, and is part of the contract for INotifyPropertyChanged.

Notas aos Herdeiros

Sempre chame a implementação base, como a primeira operação em sua implementação.Always call the base implementation, as the first operation in your implementation. A falha em fazer isso irá desabilitar significativamente todo o sistema de propriedades WPFWPF, o que faz com que valores incorretos sejam relatados.Failure to do this will significantly disable the entire WPFWPF property system, which causes incorrect values to be reported. A implementação de FrameworkElement específica também é responsável por manter o estado adequado para uma variedade de propriedades que afetam a interface do usuário visível.The specific FrameworkElement implementation is also responsible for maintaining proper state for a variety of properties that affect the visible user interface. Isso inclui a invalidação da árvore visual com base nas alterações no estilo em momentos apropriados.These include invalidating the visual tree based on changes to style at appropriate times.

Aplica-se a

Veja também