DependencyObject.OnPropertyChanged(DependencyPropertyChangedEventArgs) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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 -> unitProtected Overridable Sub OnPropertyChanged (e As DependencyPropertyChangedEventArgs)Parametry
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.