FrameworkElement.OnPropertyChanged(DependencyPropertyChangedEventArgs) FrameworkElement.OnPropertyChanged(DependencyPropertyChangedEventArgs) FrameworkElement.OnPropertyChanged(DependencyPropertyChangedEventArgs) FrameworkElement.OnPropertyChanged(DependencyPropertyChangedEventArgs) Method

Определение

Вызывается каждый раз, когда обновляется действительное значение любого свойства зависимостей для данного 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 DependencyPropertyChangedEventArgs DependencyPropertyChangedEventArgs 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.

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

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