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 可以達到更好的效能。 然而，如果 a FrameworkContentElement 包含大量值與值相關的依賴屬性，或包含必須為多個相關屬性失效案例重執行的邏輯（如渲染行為），則會使用此方法。

請注意，有一個名稱 OnPropertyChanged 相同但簽章不同的方法（參數型別為 PropertyChangedEventArgs），可以出現在多個類別上。 這 OnPropertyChanged 用於資料物件通知，也是 的合約 INotifyPropertyChanged的一部分。

給繼承者的注意事項

在實作中，務必呼叫基礎實作作為第一個操作。 若未做到此點，整個 WPF 屬性系統將大幅失效，導致錯誤值被報告。

適用於

另請參閱