FrameworkContentElement.OnPropertyChanged 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
每當這個 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)
參數
描述已變更屬性的事件資料 (包含舊值和新值)。
備註
這個方法不適合通常偵測屬性變更或失效。 相反地,如果某些資訊已知有關廣泛屬性分類的分類,它就適合修改一般失效模式。
這個方法可能會在物件存留期間多次叫用。 因此,如果您覆寫特定屬性的中繼資料,然後附加 CoerceValueCallback 或 PropertyChangedCallback 函式個別屬性,您可以達到更好的效能。 不過,如果 FrameworkContentElement 包含大量值相互關聯的相依性屬性,或是包含必須針對數個屬性失效相關案例重新執行之轉譯行為的邏輯,則使用此方法。
請注意,參數類型 PropertyChangedEventArgs (有不同簽章的相同具名 OnPropertyChanged
方法,) 可以出現在許多類別上。 這 OnPropertyChanged
用於資料物件通知,而且是 的 INotifyPropertyChanged 合約的一部分。
給繼承者的注意事項
一律呼叫基底實作,作為實作中的第一個作業。 若無法這麼做,將會大幅停用整個 WPF 屬性系統,這會導致報告不正確的值。