FrameworkContentElement.OnPropertyChanged Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows

Zestaw:: PresentationFramework.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Wywoływane za każdym razem, gdy obowiązująca wartość dowolnej właściwości zależności została FrameworkContentElement zaktualizowana. Określona właściwość zależności, która uległa zmianie, jest zgłaszana w parametrze argumentów. OnPropertyChanged(DependencyPropertyChangedEventArgs)Zastępuje .

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 zmienioną właściwość, w tym stare i nowe wartości.

Uwagi

Ta metoda nie jest przeznaczona do wykrywania zmian lub unieważnień właściwości. Zamiast tego jest przeznaczona do modyfikacji ogólnego wzorca unieważnienia, jeśli niektóre informacje są znane z szerokiej klasyfikacji właściwości.

Ta metoda jest potencjalnie wywoływana wiele razy w okresie życia obiektu. W związku z tym można osiągnąć lepszą wydajność, jeśli zastąpisz metadane określonych właściwości, a następnie dołącz CoerceValueCallback lub PropertyChangedCallback funkcje dla poszczególnych właściwości. Należy jednak użyć tej metody, jeśli element FrameworkContentElement zawiera znaczną liczbę właściwości zależności powiązanych z wartością lub jeśli zawiera logikę, taką jak zachowanie renderowania, które należy ponownie uruchomić w przypadku kilku powiązanych przypadków unieważnienia właściwości.

Należy pamiętać, że istnieje identycznie nazwana OnPropertyChanged metoda z innym podpisem (typem parametru jest PropertyChangedEventArgs) który może pojawić się w wielu klasach. Jest to OnPropertyChanged używane w przypadku powiadomień obiektów danych i jest częścią kontraktu dla INotifyPropertyChangedprogramu .

Uwagi dotyczące dziedziczenia

Zawsze należy wywołać implementację podstawową jako pierwszą operację w implementacji. Wykonanie tej czynności spowoduje znaczne wyłączenie całego systemu właściwości WPF, co powoduje zgłaszanie nieprawidłowych wartości.

Dotyczy

Udostępnij przez