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. OnPropertyChangedFreezable 재정의 구현에서는 내부 정보를 사용 하 여 속성이 하위 속성 인지 여부를 확인 하 고 두 경우 모두에 대해 적절 한 기본 클래스 논리를 제공 합니다.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.

적용 대상

추가 정보