FrameworkElement.OnPropertyChanged(DependencyPropertyChangedEventArgs) Метод

Определение

Вызывается каждый раз, когда обновляется действительное значение любого свойства зависимостей для данного FrameworkElement.Invoked whenever the effective value of any dependency property on this FrameworkElement has been updated. Конкретное измененное свойство зависимостей сообщается в параметре аргументов.The specific dependency property that changed is reported in the arguments parameter. Переопределяет OnPropertyChanged(DependencyPropertyChangedEventArgs).Overrides OnPropertyChanged(DependencyPropertyChangedEventArgs).

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)

Параметры

e
DependencyPropertyChangedEventArgs

Данные события, описывающие измененное свойство, а также старое и новое значения.The event data that describes the property that changed, as well as old and new values.

Комментарии

Этот метод не предназначен для общего обнаружения изменений свойств или недействительностей.This method is not intended to generally detect property changes or invalidations. Вместо этого он предназначен для изменения общего шаблона недействительности, если определенная информация известна по широким классификациям свойств.It is instead intended for modifications of the general invalidation pattern if certain information is known about wide classifications of properties.

Этот метод потенциально вызывается много раз в течение жизненного цикла объекта.This method is potentially invoked many times during the life of an object. Таким образом, можно добиться лучшей производительности при переопределении метаданных определенных свойств, а затем присоединить CoerceValueCallback или функции PropertyChangedCallback для отдельных свойств.Therefore, you can achieve better performance if you override the metadata of specific properties and then attach CoerceValueCallback or PropertyChangedCallback functions for individual properties. Однако этот метод следует использовать, если FrameworkElement включает значительное количество свойств зависимостей, связанных со значением, или если оно включает логику, например поведение отрисовки, которая должна быть повторно запущена для нескольких связанных вариантов недопустимых свойств.However, you would use this method if a FrameworkElement includes a significant number of value-interrelated dependency properties, or if it includes logic such as rendering behavior that must be rerun for several related cases of property invalidations.

Обратите внимание, что существует аналогично именованный метод OnPropertyChanged с другой сигнатурой (тип параметра — PropertyChangedEventArgs), который может использоваться в нескольких классах.Note that there is an identically named OnPropertyChanged method with a different signature (the parameter type is PropertyChangedEventArgs) that can appear on a number of classes. Это OnPropertyChanged используется для уведомлений объектов данных и является частью контракта для INotifyPropertyChanged.That OnPropertyChanged is used for data object notifications, and is part of the contract for INotifyPropertyChanged.

Примечания для тех, кто наследует этот метод

Всегда вызывайте базовую реализацию в качестве первой операции в реализации.Always call the base implementation, as the first operation in your implementation. Невыполнение этого действия приведет к значительному отключению всей системы свойств WPFWPF, что приводит к сообщению о неправильном значении.Failure to do this will significantly disable the entire WPFWPF property system, which causes incorrect values to be reported. Конкретная реализация FrameworkElement также отвечает за поддержание соответствующего состояния для различных свойств, влияющих на видимый пользовательский интерфейс.The specific FrameworkElement implementation is also responsible for maintaining proper state for a variety of properties that affect the visible user interface. К ним относится недействительность визуального дерева на основе изменений стиля в соответствующее время.These include invalidating the visual tree based on changes to style at appropriate times.

Применяется к

Дополнительно