FrameworkContentElement.OnPropertyChanged(DependencyPropertyChangedEventArgs) Metoda

Definicja

Wywoływana za każdym razem, gdy wartość skuteczna każdej właściwości zależności w tym FrameworkContentElement została zaktualizowana.Invoked whenever the effective value of any dependency property on this FrameworkContentElement has been updated. Określona właściwość zależności, która została zmieniona, jest raportowana w parametrze argumenty.The specific dependency property that changed is reported in the arguments parameter. Zastępuje OnPropertyChanged(DependencyPropertyChangedEventArgs).Overrides OnPropertyChanged(DependencyPropertyChangedEventArgs).

protected:
 override void OnPropertyChanged(System::Windows::DependencyPropertyChangedEventArgs e);
protected override void OnPropertyChanged (System.Windows.DependencyPropertyChangedEventArgs e);
override this.OnPropertyChanged : System.Windows.DependencyPropertyChangedEventArgs -> unit
Protected Overrides Sub OnPropertyChanged (e As DependencyPropertyChangedEventArgs)

Parametry

e
DependencyPropertyChangedEventArgs

Dane zdarzenia opisujące modyfikowaną właściwość, w tym stare i nowe wartości.The event data that describes the property that changed, including the old and new values.

Uwagi

Ta metoda nie jest przeznaczona do ogólnego wykrywania zmian właściwości lub Unieważnień.This method is not intended to generally detect property changes or invalidations. Zamiast tego jest przeznaczony do modyfikacji ogólnego wzorca unieważnienia, jeśli pewne informacje są znane o szerokiej klasyfikacji właściwości.It is instead intended for modifications of the general invalidation pattern if certain information is known about wide classifications of properties.

Ta metoda jest potencjalnie wywoływana wiele razy w okresie istnienia obiektu.This method is potentially invoked many times during the life of an object. W związku z tym można osiągnąć lepszą wydajność w przypadku zastąpienia metadanych określonych właściwości, a następnie dołączenia CoerceValueCallback lub PropertyChangedCallback funkcji dla poszczególnych właściwości.Therefore, you can achieve better performance if you override the metadata of specific properties and then attach CoerceValueCallback or PropertyChangedCallback functions for individual properties. Należy jednak użyć tej metody, jeśli FrameworkContentElement zawiera znaczącą liczbę właściwości zależności powiązanych z wartościami lub jeśli zawiera logikę, taką jak zachowanie renderowania, które należy uruchomić ponownie dla kilku powiązanych przypadków Unieważnień właściwości.However, you would use this method if a FrameworkContentElement 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.

Należy zauważyć, że istnieje taka sama nazwa OnPropertyChanged Metoda z inną sygnaturą (typ parametru to PropertyChangedEventArgs), który może występować w wielu klasach.Note that there is an identically named OnPropertyChanged method with a different signature (the parameter type is PropertyChangedEventArgs) that can appear on a number of classes. Ta OnPropertyChanged jest używana do powiadomień obiektów danych i jest częścią kontraktu dla INotifyPropertyChanged.That OnPropertyChanged is used for data object notifications, and is part of the contract for INotifyPropertyChanged.

Uwagi dotyczące dziedziczenia

Zawsze Wywołaj implementację podstawową, jako pierwszą operację w implementacji.Always call the base implementation, as the first operation in your implementation. Niewykonanie tej czynności spowoduje znacząco wyłączenie całego systemu właściwości WPFWPF, co spowoduje zgłoszenie niepoprawnych wartości.Failure to do this will significantly disable the entire WPFWPF property system, which causes incorrect values to be reported.

Dotyczy

Zobacz też