DependencyObject.OnPropertyChanged(DependencyPropertyChangedEventArgs) Yöntem

Tanım

Bunun üzerinde herhangi bir bağımlılık özelliğinin etkin değeri DependencyObject güncelleştirildiğinde çağrılır.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. Değiştirilen belirli bağımlılık özelliği olay verilerinde raporlanır.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)

Parametreler

e
DependencyPropertyChangedEventArgs

İlgilendiğiniz bağımlılık özelliği tanımlayıcısını, türün özellik meta verilerini ve eski ve yeni değerleri içerecek olay verileri.Event data that will contain the dependency property identifier of interest, the property metadata for the type, and old and new values.

Açıklamalar

Bu yöntem, genel olarak tek tek özellik değişikliklerini algılamaya veya özelliklerin büyük/küçük bir dönem içinde yük doğrulamalarını gerçekleştirmeye yönelik değildir.This method is not intended to generally detect individual property changes or perform invalidations of properties on a per-case basis. OnPropertyChanged , belirli bilgiler, özelliklerin geniş sınıflandırmalarıyla ilgili olarak tanınıyorsa, genel ınvalidation deseninin değişikliklerine yöneliktir.OnPropertyChanged is instead intended for modifications of the general invalidation pattern, if certain information is known about wide classifications of properties. Örneğin, bir içindeki değişiklikler Freezable , ' ın değer türlerinde değişiklikler olabilir Freezable veya değişikliklerin diğer başvuruların içinde olduğu alt özellikler olabilir Freezable .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. FreezableUygulamasının geçersiz kılma uygulanması, OnPropertyChanged özelliklerin alt özellikler olup olmadığını ve her iki durumda da uygun temel sınıf mantığını sağlar.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 , bir nesnenin ömrü boyunca çok sayıda kez çağrılabilir.OnPropertyChanged is potentially invoked many times during the life of an object. Bu nedenle, belirli özelliklerin meta verilerini geçersiz kılarsınız ve sonra CoerceValueCallback bağımsız özellikler için veya işlevleri eklerseniz, genel özellik sistemi için daha iyi performans elde edebilirsiniz PropertyChangedCallback .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. Ancak, bu yöntemi, bir DependencyObject değer ile ilişkili önemli bir bağımlılık özelliği içeriyorsa veya özellik geçersiz kılma işlemleri için yeniden çalıştırılması gereken işleme davranışı gibi bir mantık içeriyorsa, bu yöntemi kullanabilirsiniz.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.

Devralanlara Notlar

Her zaman temel uygulamayı çağırın.Always call the base implementation. Bunun yapılmaması, tüm özellik sistemini önemli ölçüde devre dışı bırakarak WPFWPF Hatalı değerlerin raporlanmasına neden olur.Failure to do this will significantly disable the entire WPFWPF property system, causing incorrect values to be reported.

Şunlara uygulanır

Ayrıca bkz.