FrameworkElement.OnPropertyChanged(DependencyPropertyChangedEventArgs) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Вызывается каждый раз, когда обновляется действительное значение любого свойства зависимостей для данного FrameworkElement. Конкретное измененное свойство зависимостей сообщается в параметре аргументов. Переопределяет 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)Параметры
Данные события, описывающие измененное свойство, а также старое и новое значения.
Комментарии
Этот метод не предназначен для обнаружения изменений или недействительности свойств. Вместо этого он предназначен для изменения общего шаблона недействительности, если известны определенные сведения о широких классификациях свойств.
Этот метод может вызываться много раз в течение жизненного срока существования объекта. Таким образом, вы можете добиться лучшей производительности, если переопределить метаданные определенных свойств, а затем прикрепить CoerceValueCallback функции или PropertyChangedCallback для отдельных свойств. Однако этот метод используется, если FrameworkElement включает значительное количество свойств зависимостей, связанных со значениями, или если он включает логику, например поведение отрисовки, которое необходимо повторно запускать для нескольких связанных случаев недействительности свойств.
Обратите внимание, что имеется метод с одинаковым именем OnPropertyChanged с другой сигнатурой (тип параметра — PropertyChangedEventArgs), который может отображаться в ряде классов. Используется OnPropertyChanged для уведомлений об объектах данных и является частью контракта для INotifyPropertyChanged.
Примечания для тех, кто наследует этот метод
Всегда вызывайте базовую реализацию в качестве первой операции в реализации. В противном случае система свойств WPF будет значительно отключена, что приведет к выводу неверных значений. FrameworkElement Конкретная реализация также отвечает за поддержание надлежащего состояния для различных свойств, влияющих на видимый пользовательский интерфейс. К ним относится аннулирование визуального дерева на основе изменений стиля в соответствующее время.
