FrameworkContentElement.OnPropertyChanged Метод

Определение

Вызывается каждый раз, когда обновляется действительное значение любого свойства зависимостей для данного FrameworkContentElement. Конкретное измененное свойство зависимостей сообщается в параметре аргументов. Переопределяет 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 функции для отдельных свойств. Однако этот метод следует использовать, если включает FrameworkContentElement значительное количество свойств зависимостей, связанных со значениями, или если он включает логику, например поведение отрисовки, которое необходимо повторно запустить для нескольких связанных случаев с недействительными свойств.

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

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

Всегда вызывайте базовую реализацию в качестве первой операции в реализации. Сбой в этом случае значительно отключит всю систему свойств WPF, что приводит к выводу неверных значений.

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

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