FrameworkElement.OnPropertyChanged(DependencyPropertyChangedEventArgs) 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 zostanie zaktualizowana efektywna wartość dowolnej właściwości FrameworkElement zależności. Określona właściwość zależności, która uległa zmianie, jest zgłaszana w parametrze argumentów. Zastępuje metodę OnPropertyChanged(DependencyPropertyChangedEventArgs).
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ść, a także stare i nowe wartości.
Uwagi
Ta metoda nie jest przeznaczona do wykrywania zmian lub unieważnień właściwości. Zamiast tego jest przeznaczony do modyfikacji ogólnego wzorca unieważniania, 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 lub CoerceValueCallbackPropertyChangedCallback funkcje dla poszczególnych właściwości. Można jednak użyć tej metody, jeśli element FrameworkElement 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 (typ parametru to PropertyChangedEventArgs), który może występować w wielu klasach. Jest to OnPropertyChanged używane na potrzeby powiadomień dotyczących obiektów danych i jest częścią kontraktu dla elementu INotifyPropertyChanged.
Uwagi dotyczące dziedziczenia
Zawsze należy wywołać implementację podstawową jako pierwszą operację w implementacji. Nie można tego zrobić spowoduje znaczne wyłączenie całego systemu właściwości WPF, co powoduje zgłaszanie nieprawidłowych wartości. FrameworkElement Konkretna implementacja jest również odpowiedzialna za utrzymanie odpowiedniego stanu dla różnych właściwości, które mają wpływ na widoczny interfejs użytkownika. Obejmują one unieważnienie drzewa wizualnego na podstawie zmian stylu w odpowiednim czasie.
