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

Параметры

e
DependencyPropertyChangedEventArgs

Данные события, описывающие измененное свойство, а также старое и новое значения.

Комментарии

Этот метод не предназначен для общего обнаружения изменений свойств или недействительностей. Вместо этого он предназначен для изменения общего шаблона недействительности, если определенная информация известна по широким классификациям свойств.

Этот метод потенциально вызывается много раз в течение жизненного цикла объекта. Таким образом, можно добиться лучшей производительности при переопределении метаданных определенных свойств и последующем присоединении CoerceValueCallback PropertyChangedCallback функций или к отдельным свойствам. Однако этот метод следует использовать, если FrameworkElement включает значительное количество свойств зависимостей, взаимосвязанных со значениями, или если оно включает логику, например поведение отрисовки, которая должна быть повторно запущена для нескольких связанных вариантов недопустимых свойств.

Обратите внимание, что существует аналогично именованный OnPropertyChanged метод с другой сигнатурой (тип параметра — PropertyChangedEventArgs ), который может использоваться в нескольких классах. OnPropertyChangedИспользуется для уведомлений объектов данных и является частью контракта для INotifyPropertyChanged .

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

Всегда вызывайте базовую реализацию в качестве первой операции в реализации. Невыполнение этого действия приведет к значительному отключению всей системы свойств WPF, что приводит к сообщению о неправильном значении. Конкретная FrameworkElement Реализация также отвечает за поддержание соответствующего состояния для различных свойств, влияющих на видимый пользовательский интерфейс. К ним относится недействительность визуального дерева на основе изменений стиля в соответствующее время.

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

См. также раздел