Udostępnij za pośrednictwem


DependencyObject.OnPropertyChanged(DependencyPropertyChangedEventArgs) Metoda

Definicja

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 -> unit
Protected Overridable Sub OnPropertyChanged (e As DependencyPropertyChangedEventArgs)

Parametry

e
DependencyPropertyChangedEventArgs

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.

Dotyczy

Zobacz też