FrameworkContentElement.OnPropertyChanged 方法

定义

命名空间:
System.Windows
程序集:
PresentationFramework.dll

每当更新此 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 属性系统，这会导致报告不正确的值。

适用于

另请参阅