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ána vždy, když byla aktualizována efektivní hodnota jakékoli vlastnosti závislosti na této DependencyObject vlastnosti. Konkrétní vlastnost závislosti, 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ávislosti, metadata vlastností pro typ a staré a nové hodnoty.
Poznámky
Tato metoda není určena k obecné detekci jednotlivých změn vlastností nebo provádění zneplatnění vlastností na základě jednotlivých případů. OnPropertyChanged je místo toho určena k úpravám obecného vzoru zneplatnění, pokud jsou určité informace známé o široké klasifikaci vlastností. Změny v hodnotových Freezable typech můžou být například změny v typech Freezablehodnot nebo můžou být dílčími funkcemi, kde se změny nacházejí v jiných Freezable odkazech. Přepsání Freezable implementace OnPropertyChanged používá interní informace k určení, zda jsou vlastnosti dílčími obdobími, a poskytuje odpovídající logiku základní třídy pro oba případy.
OnPropertyChanged je potenciálně vyvolána mnohokrát během života 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ě DependencyObject , že zahrnuje významný počet vlastností závislostí souvisejících 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ů zneplatnění vlastností.
Poznámky pro dědice
Vždy volejte základní implementaci. Pokud to neuděláte, výrazně se zakáže celý systém vlastností WPF (Windows Presentation Foundation), což způsobí nahlášení nesprávných hodnot.
