DependencyObject.OnPropertyChanged(DependencyPropertyChangedEventArgs) DependencyObject.OnPropertyChanged(DependencyPropertyChangedEventArgs) DependencyObject.OnPropertyChanged(DependencyPropertyChangedEventArgs) DependencyObject.OnPropertyChanged(DependencyPropertyChangedEventArgs) Method

Definição

Invocado sempre que o valor efetivo de qualquer propriedade de dependência nesse DependencyObject for atualizada.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. A propriedade de dependência específica que mudou é relatada os dados do evento.The specific dependency property that changed is reported in the event data.

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

Parâmetros

e
DependencyPropertyChangedEventArgs DependencyPropertyChangedEventArgs DependencyPropertyChangedEventArgs DependencyPropertyChangedEventArgs

Os dados do evento conterão o identificador de propriedade de dependência de interesse, os metadados para o tipo de propriedade e valores novos e antigos.Event data that will contain the dependency property identifier of interest, the property metadata for the type, and old and new values.

Comentários

Esse método não pretende geralmente detectar alterações de propriedade individuais ou executar invalidações de propriedades de acordo com cada caso.This method is not intended to generally detect individual property changes or perform invalidations of properties on a per-case basis. OnPropertyChangedem vez disso, é destinado a modificações do padrão invalidação geral, se determinadas informações forem conhecidas sobre classificações amplas de propriedades.OnPropertyChanged is instead intended for modifications of the general invalidation pattern, if certain information is known about wide classifications of properties. Por exemplo, as alterações em Freezable um podem ser alterações nos tipos Freezablede valor de, ou podem ser subpropriedades, em que as alterações estão Freezable dentro de outras referências.For example, changes in a Freezable might be changes in the value types of the Freezable, or might be subproperties, where the changes are within other Freezable references. A Freezable implementação de substituição OnPropertyChanged de usa informações internas para determinar se as propriedades são subpropriedades e fornece a lógica de classe base apropriada para ambos os casos.The Freezable override implementation of OnPropertyChanged uses internal information to determine whether the properties are subproperties, and provides appropriate base class logic for either case.

OnPropertyChangedé potencialmente invocado muitas vezes durante a vida útil de um objeto.OnPropertyChanged is potentially invoked many times during the life of an object. Portanto, você pode obter um melhor desempenho para o sistema de propriedades geral se substituir os metadados de propriedades específicas e, CoerceValueCallback em PropertyChangedCallback seguida, anexar ou funções para propriedades individuais.Therefore, you can achieve better performance for the overall property system 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 DependencyObject um incluir um número significativo de propriedades de dependência relacionadas a valores, ou se ela incluir uma lógica como o comportamento de renderização que deve ser executado novamente para vários casos relacionados de invalidações de propriedade.However, you would use this method if a DependencyObject 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.

Notas aos Herdeiros

Sempre chame a implementação base.Always call the base implementation. A falha em fazer isso irá desabilitar significativamente o WPFWPF sistema de propriedades inteiro, fazendo com que valores incorretos sejam relatados.Failure to do this will significantly disable the entire WPFWPF property system, causing incorrect values to be reported.

Aplica-se a

Veja também