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

描述已更改的属性的事件数据(包括旧值和新值)。

注解

此方法不用于通常检测属性更改或失效。 相反,如果某些有关属性宽分类的已知信息,则它旨在修改一般失效模式。

此方法可能在对象的生命周期内多次调用。 因此,如果重写特定属性的元数据,然后为各个属性附加 CoerceValueCallbackPropertyChangedCallback 函数,则可以获得更好的性能。 但是,如果 FrameworkElement 包含大量与值相关的依赖属性,或者它包含必须针对多个相关属性失效情况重新运行的呈现行为等逻辑,则可以使用此方法。

请注意,参数类型 (参数类型PropertyChangedEventArgs可以出现在多个类上) 具有相同命名OnPropertyChanged的方法。 用于 OnPropertyChanged 数据对象通知,是协定 INotifyPropertyChanged的一部分。

继承者说明

始终调用基本实现,作为实现中的第一个操作。 无法执行此操作会显著禁用整个 WPF 属性系统,这会导致报告不正确的值。 特定 FrameworkElement 实现还负责维护影响可见用户界面的各种属性的正确状态。 这包括根据对样式的更改在适当时间使可视化树失效。

适用于

另请参阅