다음을 통해 공유


DataContextChangedEventArgs 클래스

정의

DataContextChanged 이벤트에 대한 데이터를 제공합니다.

public ref class DataContextChangedEventArgs sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DataContextChangedEventArgs final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DataContextChangedEventArgs final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class DataContextChangedEventArgs
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class DataContextChangedEventArgs
Public NotInheritable Class DataContextChangedEventArgs
상속
Object Platform::Object IInspectable DataContextChangedEventArgs
특성

Windows 요구 사항

디바이스 패밀리
Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract
Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

설명

FrameworkElement.DataContext 속성에는 해당 값이 DataContext 값이 설정된 FrameworkElement의 모든 FrameworkElement 자식 요소에 상속되는 기본 제공 동작이 있습니다. 이 동작을 사용하면 관련 요소 집합이 동일한 컨텍스트를 사용하여 다른 원본 속성에 바인딩할 수 있습니다. 이는 항목 템플릿, 데이터 템플릿 및 기타 데이터 바인딩 시나리오에 특히 유용합니다. DataContext는 상속되므로 상속된 값을 사용하여 다른 DataContextChanged 이벤트를 발생시키는 각 FrameworkElement에 대한 가능성이 있습니다. 해당 이벤트는 요소가 상속된 DataContext 값이 변경되었음을 감지하면 부모 요소가 아닌 상속 요소에서 가져옵니다. 이 동작을 원하지 않는 경우 부모 원본에서 DataContextChanged 이벤트를 처리해야 합니다. 여기서 이벤트가 먼저 발생합니다. 처리기 논리의 일부로 DataContextChangedEventArgs 이벤트 데이터의 Handled 속성 값을 true로 설정합니다. 이 작업을 수행하면 이벤트가 자식 요소로 라우팅되지 않습니다.

참고

DataContextChanged 에는 라우팅 동작이 있지만 실제 라우트된 이벤트가 아닙니다( RoutedEvent 식별자가 없음). 또한 부모에서 자식으로 라우팅되는 반면, 실제 라우트된 이벤트는 자식에서 부모로 라우팅됩니다. WPF(Windows Presentation Foundation)에 익숙한 경우 DataContextChanged는 Windows Presentation Foundation(WPF) 이벤트 라우팅 정의에 의한 터널링 라우팅 이벤트로 간주될 수 있습니다.

속성

Handled

DataContext 값을 상속하고 값이 변경되었음을 감지하는 자식 요소에서 다른 DataContextChanged 이벤트를 발생시켜야 하는지 여부에 영향을 주는 값을 가져오거나 설정합니다.

NewValue

DataContextChanged 이벤트가 발생한 요소에 대한 새 DataContext 값을 가져옵니다.

적용 대상

추가 정보