Sdílet prostřednictvím


DependencyObject.OnPropertyChanged(DependencyPropertyChangedEventArgs) Metoda

Definice

Vyvolá se při každé aktualizaci efektivní hodnoty jakékoli vlastnosti závislosti na této DependencyObject vlastnosti. Specifická vlastnost závislostí, která se změnila, je hlášena v datech události.

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)

Parametry

e
DependencyPropertyChangedEventArgs

Data událostí, která budou obsahovat identifikátor vlastnosti závislostí, metadata vlastností pro typ a staré a nové hodnoty.

Poznámky

Tato metoda není určena k obecné detekci změn jednotlivých vlastností nebo provádění neplatných vlastností na základě jednotlivých případů. OnPropertyChanged je místo toho určena pro úpravy obecného způsobu zneplatnění, pokud jsou určité informace známé o širokých klasifikacích vlastností. Změny v objektu Freezable mohou být například změněny v typech Freezablehodnot nebo mohou být dílčími vazbami, kde se změny nacházejí v jiných Freezable odkazech. Přepsání Freezable implementace použití interních OnPropertyChanged informací k určení, zda jsou vlastnosti dílčími vlastnostmi, a poskytuje odpovídající logiku základní třídy pro oba případy.

OnPropertyChanged je potenciálně vyvolán mnohokrát během životnosti objektu. Proto můžete dosáhnout lepšího výkonu pro celkový systém vlastností, pokud přepíšete metadata konkrétních vlastností a pak připojíte CoerceValueCallback nebo PropertyChangedCallback funkce pro jednotlivé vlastnosti. Tuto metodu byste však použili v případě, že DependencyObject obsahuje významný počet vlastností závislosti související s hodnotou nebo pokud obsahuje logiku, jako je chování vykreslování, které je nutné znovu spustit pro několik souvisejících případů neplatných vlastností.

Poznámky pro dědice

Vždy volejte základní implementaci. Pokud to neuděláte, dojde k významnému zakázání celého systému vlastností WPF, což způsobí nahlášení nesprávných hodnot.

Platí pro

Viz také