DependencyObject.OnPropertyChanged(DependencyPropertyChangedEventArgs) DependencyObject.OnPropertyChanged(DependencyPropertyChangedEventArgs) DependencyObject.OnPropertyChanged(DependencyPropertyChangedEventArgs) DependencyObject.OnPropertyChanged(DependencyPropertyChangedEventArgs) Method

定義

この DependencyObject の依存関係プロパティの有効値が更新された場合に必ず呼び出されます。Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. 変更が発生した特定の依存関係プロパティがイベント データで報告されます。The specific dependency property that changed is reported in the event data.

protected:
 virtual void OnPropertyChanged(System::Windows::DependencyPropertyChangedEventArgs e);
protected virtual void OnPropertyChanged (System.Windows.DependencyPropertyChangedEventArgs e);
abstract member OnPropertyChanged : System.Windows.DependencyPropertyChangedEventArgs -> unit
override this.OnPropertyChanged : System.Windows.DependencyPropertyChangedEventArgs -> unit
Protected Overridable Sub OnPropertyChanged (e As DependencyPropertyChangedEventArgs)

パラメーター

e
DependencyPropertyChangedEventArgs DependencyPropertyChangedEventArgs DependencyPropertyChangedEventArgs DependencyPropertyChangedEventArgs

目的の依存関係プロパティの識別子、その型のプロパティ メタデータ、および古い値と新しい値を格納するイベント データ。Event data that will contain the dependency property identifier of interest, the property metadata for the type, and old and new values.

注釈

このメソッドは、通常、個々 のプロパティの変更を検出するか、ケースごとにプロパティの無効化を実行するものではありません。This method is not intended to generally detect individual property changes or perform invalidations of properties on a per-case basis. OnPropertyChanged 代わりに、変更、無効化の一般的なパターンのプロパティの広範な分類について特定の情報がわかっている場合です。OnPropertyChanged is instead intended for modifications of the general invalidation pattern, if certain information is known about wide classifications of properties. 変更など、Freezableの値の型の変更があります、 Freezable、または可能性があります、サブプロパティ他内で変更された箇所Freezable参照。For example, changes in a Freezable might be changes in the value types of the Freezable, or might be subproperties, where the changes are within other Freezable references. Freezableの実装をオーバーライドOnPropertyChangedプロパティ、サブプロパティと、どちらの場合も適切な基本クラス ロジックを提供するかどうかを判断する内部情報を使用します。The Freezable override implementation of OnPropertyChanged uses internal information to determine whether the properties are subproperties, and provides appropriate base class logic for either case.

OnPropertyChanged オブジェクトの有効期間中に何度もを呼び出す可能性のあります。OnPropertyChanged is potentially invoked many times during the life of an object. 固有のプロパティのメタデータをオーバーライドし、適用する場合、全体的なプロパティ システムのパフォーマンスが向上を実現するそのため、CoerceValueCallbackまたはPropertyChangedCallback個々 のプロパティ。Therefore, you can achieve better performance for the overall property system if you override the metadata of specific properties and then attach CoerceValueCallback or PropertyChangedCallback functions for individual properties. 場合にこのメソッドを使用すると、DependencyObject多数値と相互に依存関係プロパティにはが含まれています動作をレンダリングする必要がありますを再実行するいくつかの関連プロパティの無効化のケースのようにロジックが含まれている場合またはします。However, you would use this method if a DependencyObject includes a significant number of value-interrelated dependency properties, or if it includes logic such as rendering behavior that must be rerun for several related cases of property invalidations.

注意 (継承者)

常に、基本実装を呼び出します。Always call the base implementation. これに失敗には、全体が無効になりますが大幅にWPFWPFプロパティ システムが壊れ、不適切な値が報告されます。Failure to do this will significantly disable the entire WPFWPF property system, causing incorrect values to be reported.

適用対象

こちらもご覧ください