DependencyObject.OnPropertyChanged(DependencyPropertyChangedEventArgs) 메서드

정의

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

관심 있는 종속성 속성 식별자, 형식에 대한 속성 메타데이터, 기존 값 및 새 값을 포함하는 이벤트 데이터입니다.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. 이 작업을 수행 하지 못하면 전체 WPF 속성 시스템을 사용 하지 않도록 설정 하 여 잘못 된 값을 보고 합니다.Failure to do this will significantly disable the entire WPF property system, causing incorrect values to be reported.

적용 대상

추가 정보