FrameworkContentElement.OnPropertyChanged Metoda
Definicja
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 -> unitProtected Overrides Sub OnPropertyChanged (e As DependencyPropertyChangedEventArgs)Parametry
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.