DependencyObject.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 obowiązująca wartość dowolnej właściwości zależności została DependencyObject zaktualizowana. Określona właściwość zależności, która uległa zmianie, jest zgłaszana w danych zdarzenia.
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 -> unitProtected Overridable Sub OnPropertyChanged (e As DependencyPropertyChangedEventArgs)Parametry
Dane zdarzenia, które będą zawierać identyfikator właściwości zależności, metadane właściwości dla typu oraz stare i nowe wartości.
Uwagi
Ta metoda nie jest przeznaczona do wykrywania zmian poszczególnych właściwości lub przeprowadzania unieważnień właściwości w poszczególnych przypadkach. OnPropertyChanged Zamiast tego jest przeznaczony do modyfikacji ogólnego wzorca unieważnienia, jeśli niektóre informacje są znane z szerokiej klasyfikacji właściwości. Na przykład zmiany w obiekcie Freezable mogą być zmianami w typach Freezablewartości elementu lub mogą być podwłaściwości, w których zmiany znajdują się w innych Freezable odwołaniach. Implementacja Freezable zastąpienia OnPropertyChanged używa informacji wewnętrznych w celu określenia, czy właściwości są podwłaściwości, i zapewnia odpowiednią logikę klasy bazowej dla obu przypadków.
OnPropertyChanged jest potencjalnie wywoływana wiele razy w okresie życia obiektu. W związku z tym można osiągnąć lepszą wydajność dla ogólnego systemu właściwości, 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 DependencyObject 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.
Uwagi dotyczące dziedziczenia
Zawsze należy wywołać implementację podstawową. Wykonanie tej czynności spowoduje znaczne wyłączenie całego systemu właściwości WPF, co powoduje zgłaszanie nieprawidłowych wartości.
