DependencyObject.OnPropertyChanged(DependencyPropertyChangedEventArgs) Metodo

Definizione

Spazio dei nomi:

System.Windows

Assembly:

WindowsBase.dll

Richiamato ogni volta che viene aggiornato il valore effettivo di qualsiasi proprietà di dipendenza in DependencyObject. La proprietà di dipendenza specifica modificata viene indicata nei dati dell'evento.

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)

Parametri

e

DependencyPropertyChangedEventArgs

Dati dell'evento che conterranno l'identificatore della proprietà di dipendenza di interesse, i metadati della proprietà per il tipo e i valori precedenti e nuovi.

Commenti

Questo metodo non è progettato per rilevare in genere singole modifiche alle proprietà o per eseguire invalidazioni delle proprietà in base al caso. OnPropertyChanged è invece destinato alle modifiche del modello di invalidazione generale, se alcune informazioni sono note sulle classificazioni estese delle proprietà. Ad esempio, le modifiche apportate a un Freezable oggetto potrebbero essere modifiche nei tipi valore di Freezableo potrebbero essere sottoproprietà, in cui le modifiche si trovano all'interno di altri Freezable riferimenti. L'implementazione Freezable di override di OnPropertyChanged usa informazioni interne per determinare se le proprietà sono proprietà secondarie e fornisce la logica della classe di base appropriata per entrambi i casi.

OnPropertyChanged viene potenzialmente richiamato molte volte durante la vita di un oggetto. Pertanto, è possibile ottenere prestazioni migliori per il sistema di proprietà complessivo se si eseguono l'override dei metadati di proprietà specifiche e quindi si collegano CoerceValueCallback o PropertyChangedCallback funzioni per singole proprietà. Tuttavia, è consigliabile usare questo metodo se include DependencyObject un numero significativo di proprietà di dipendenza correlate a valori o se include logica, ad esempio il comportamento di rendering che deve essere rieseguito per diversi casi correlati di invalidazioni delle proprietà.

Note per gli eredi

Chiamare sempre l'implementazione di base. In caso contrario, l'intero sistema di proprietà WPF verrà disabilitato in modo significativo, causando la segnalazione di valori non corretti.

Vedi anche

• FrameworkElement