종속성 속성 메타데이터

아티클
05/04/2023

WPF(Windows Presentation Foundation) 속성 시스템에는 리플렉션이나 일반적인 CLR(공용 언어 런타임) 특성을 통해 속성에 대해 보고할 수 있는 수준을 넘어서는 메타데이터 보고 시스템이 포함됩니다. 또한 종속성 속성에 대한 메타데이터는 종속성 속성을 정의하는 클래스에서 고유하게 할당하고, 종속성 속성이 다른 클래스에 추가될 때 변경하며, 정의하는 기본 클래스에서 종속성 속성을 상속하는 모든 파생 클래스에서 구체적으로 재정의할 수 있습니다.

필수 조건

이 항목에서는 WPF 클래스에 대한 기존 종속성 속성의 소비자 관점에서 종속성 속성을 이해하고 종속성 속성 개요를 읽었다고 가정합니다. 이 항목의 예제를 따르려면 XAML을 이해하고 WPF 애플리케이션을 작성하는 방법도 알아야 합니다.

종속성 속성 메타데이터를 사용하는 방법

종속성 속성 메타데이터는 종속성 속성의 특성을 검사하기 위해 쿼리할 수 있는 개체로 존재합니다. 또한 이 메타데이터는 속성 시스템에서 제공된 종속성 속성을 처리할 때 자주 액세스합니다. 종속성 속성에 대한 메타데이터 개체에는 다음과 같은 유형의 정보가 포함될 수 있습니다.

로컬 값, 스타일, 상속 등으로 종속성 속성의 다른 값을 확인할 수 없는 경우 종속성 속성의 기본값입니다. 종속성 속성의 값을 할당할 때 기본값이 속성 시스템에서 사용하는 우선 순위에 참여하는 방법에 관한 자세한 내용은 종속성 속성 값 우선 순위를 참조하세요.
소유자 유형별로 강제 변환 또는 변경 알림 동작에 영향을 주는 콜백 구현에 대한 참조. 이러한 콜백은 종종 public이 아닌 액세스 수준으로 정의되므로 일반적으로 참조가 허용된 액세스 범위 내에 있지 않으면 메타데이터에서 실제 참조를 가져올 수 없습니다. 종속성 속성 콜백에 대한 자세한 내용은 종속성 속성 콜백 및 유효성 검사를 참조하세요.
해당 종속성 속성이 WPF 프레임워크 수준 속성으로 간주되는 경우 메타데이터에는 WPF 프레임워크 수준 레이아웃 엔진 및 속성 상속 논리 같은 서비스에 대한 정보 및 상태를 보고하는 WPF 프레임워크 수준 종속성 속성 특성이 포함될 수 있습니다. 이러한 측면의 종속성 속성 메타데이터에 대한 자세한 내용은 프레임워크 속성 메타데이터를 참조하세요.

메타데이터 API

속성 시스템에서 사용하는 대부분의 메타데이터 정보를 보고하는 형식은 PropertyMetadata 클래스입니다. 메타데이터 인스턴스는 종속성 속성이 속성 시스템에 등록될 때 필요에 따라 지정되며 소유자로 자신을 추가하거나 기본 클래스 종속성 속성 정의에서 상속되는 메타데이터를 재정의하는 추가 형식에 대해 다시 지정할 수 있습니다. (속성 등록이 메타데이터를 지정하지 않는 경우 기본 PropertyMetadata는 해당 클래스의 기본값으로 만들어집니다.) 등록된 메타데이터는 DependencyObject 인스턴스에 대한 종속성 속성에서 메타데이터를 가져오는 다양한 GetMetadata 오버로드를 호출할 때 PropertyMetadata로 반환됩니다.

그러면 PropertyMetadata 클래스가 파생되어 WPF 프레임워크 수준 클래스와 같은 아키텍처 구분에 대해 보다 구체적인 메타데이터를 제공합니다. UIPropertyMetadata는 애니메이션 보고를 추가하고 FrameworkPropertyMetadata는 이전 섹션에서 언급된 WPF 프레밍워크 수준 속성을 제공합니다. 종속성 속성을 등록하면 이러한 PropertyMetadata 파생 클래스에 등록할 수 있습니다. 메타데이터를 검사하는 경우 기본 PropertyMetadata 형식을 파생 클래스로 캐스트하여 보다 구체적인 속성을 검사할 수 있습니다.

참고

경우에 따라 이 설명서에서는 FrameworkPropertyMetadata에 지정할 수 있는 속성 특성을 “플래그”라고 합니다. 종속성 속성 등록이나 메타데이터 재정의에서 사용할 새 메타데이터 인스턴스를 만들 때 플래그 열거형 FrameworkPropertyMetadataOptions를 사용하여 이러한 값을 지정한 다음, 열거형의 연결된 값을 FrameworkPropertyMetadata 생성자에 제공합니다. 그러나 생성된 이러한 옵션 특성은 FrameworkPropertyMetadata 내에서 생성하는 열거형 값이 아니라 일련의 부울 속성으로 노출됩니다. 부울 속성을 사용하면 플래그 열거형 값에 마스크를 적용하여 관심 있는 정보를 가져오는 대신 각 조건을 확인할 수 있습니다. 생성자는 생성자 시그니처의 길이를 적절히 유지하기 위해 연결된 FrameworkPropertyMetadataOptions를 사용하는 반면, 실제 생성된 메타데이터는 메타데이터를 보다 직관적으로 쿼리하기 위해 개별 속성을 노출합니다.

메타데이터를 재정의하는 경우, 클래스를 파생시키는 경우

WPF 속성 시스템은 종속성 속성의 일부 특성을 완전히 다시 구현할 필요 없이 변경하는 기능을 설정했습니다. 이 기능은 특정 형식에 있는 종속성 속성에 대한 속성 메타데이터의 다른 인스턴스를 생성하여 수행합니다. 대부분의 기존 종속성 속성은 가상 속성이 아닙니다. 따라서 엄밀히 말해 상속된 클래스에서 "다시 구현"하려면 기존 멤버를 숨겨야만 합니다.

특정 형식에 있는 종속성 속성에 대해 사용하려는 시나리오를 기존 종속성 속성의 특성을 수정하여 수행할 수 없는 경우 파생 클래스를 만든 다음 해당 파생 클래스에서 사용자 지정 종속성 속성을 선언해야 할 수 있습니다. 사용자 지정 종속성 속성은 WPF API에서 정의된 종속성 속성과 동일하게 동작합니다. 사용자 지정 종속성 속성에 대한 자세한 내용은 사용자 지정 종속성 속성을 참조하세요.

재정의할 수 없는 종속성 속성의 주요 특성 한 가지는 해당 값 형식입니다. 필요한 유사한 동작을 수행하는 종속성 속성을 상속하려고 하는데 다른 형식이 필요한 경우 사용자 지정 종속성 속성을 구현하고 사용자 지정 클래스에서 형식 변환이나 다른 구현을 통해 속성을 연결해야 합니다. 또한 기존 ValidateValueCallback 콜백은 메타데이터 내가 아니라 등록 필드 자체에 존재하기 때문에 바꿀 수 없습니다.

기존 메타데이터 변경 시나리오

기존 종속성 속성의 메타데이터를 사용하여 작업하는 경우 종속성 속성 메타데이터를 변경하는 한 가지 일반적인 시나리오는 기본값을 변경하는 것입니다. 속성 시스템 콜백 변경 또는 추가는 고급 시나리오입니다. 파생 클래스의 구현이 종속성 속성 간에 다른 상관 관계를 갖는 경우 이 작업을 수행하는 것이 좋습니다. 코드와 선언적 사용을 모두 지원하는 프로그래밍 모델의 조건 중 하나는 순서에 관계없이 속성을 설정할 수 있어야 하는 것입니다. 따라서 모든 종속 속성은 컨텍스트 없이 적시에 설정해야 하며 생성자에서 찾을 수 있는 설정 순서를 사용할 필요가 없습니다. 속성 시스템의 이러한 측면에 대한 자세한 내용은 종속성 속성 콜백 및 유효성 검사를 참조하세요. 유효성 검사 콜백은 메타데이터의 일부가 아니라 종속성 속성 식별자의 일부입니다. 따라서 유효성 검사 콜백은 메타데이터를 재정의하여 변경할 수 없습니다.

경우에 따라 기존 종속성 속성에서 WPF 프레임워크 수준 속성 메타데이터 옵션을 변경하려고 할 수도 있습니다. 이러한 옵션은 WPF 프레임워크 수준 속성에 대한 알려진 특정 조건을 레이아웃 시스템 같은 다른 WPF 프레임워크 수준 프로세스에 전달합니다. 옵션 설정은 일반적으로 새 종속성 속성을 등록할 때 이루어지지만 OverrideMetadata 또는 AddOwner 호출의 일부로 WPF 프레임워크 수준 속성 메타데이터를 변경할 수도 있습니다. 사용할 특정 값 및 자세한 내용은 프레임워크 속성 메타데이터를 참조하세요. 새로 등록된 종속성 속성에 대해 이러한 옵션을 설정하는 방법과 관련된 자세한 내용은 사용자 지정 종속성 속성을 참조하세요.

메타데이터 재정의

메타데이터 재정의의 용도는 특정 형식에 있는 종속성 속성에 적용되는 다양한 메타데이터 파생 동작을 변경할 수 있도록 하는 것입니다. 그 이유는 메타데이터 섹션에 자세히 설명되어 있습니다. 몇 가지 코드 예제를 비롯한 자세한 내용은 종속성 속성의 메타데이터 재정의를 참조하세요.

속성 메타데이터는 등록 호출(Register) 중 종속성 속성에 대해 제공할 수 있습니다. 그러나 대부분의 경우 해당 종속성 속성을 상속하는 클래스에 대해 형식별 메타데이터를 제공하려고 합니다. 이 작업은 OverrideMetadata 메서드를 호출하여 수행할 수 있습니다. WPF API의 예제에서 FrameworkElement 클래스는 Focusable 종속성 속성을 처음 등록하는 형식입니다. 그러나 Control 클래스는 종속성 속성에 대한 메타데이터를 재정의하여 고유한 초기 기본값을 제공하고 false에서 true로 변경하며, 그렇지 않으면 원래 Focusable 구현을 다시 사용합니다.

메타데이터를 재정의하는 경우 서로 다른 메타데이터 특성이 병합되거나 대체됩니다.

PropertyChangedCallback가 병합됩니다. 새 PropertyChangedCallback을 추가하면 해당 콜백은 메타데이터에 저장됩니다. 재정의에서 PropertyChangedCallback을 지정하지 않으면 PropertyChangedCallback 값은 메타데이터에서 이를 지정한 가장 가까운 상위 항목의 참조로 승격됩니다.
PropertyChangedCallback의 실제 속성 시스템 동작은 계층 구조의 모든 메타데이터 소유자에 대한 구현을 유지하고 최다 파생 클래스의 콜백이 먼저 호출되는 속성 시스템의 실행 순서로 테이블에 추가하는 것입니다.
DefaultValue가 바뀌었습니다. 재정의에서 DefaultValue을 지정하지 않으면 DefaultValue 값은 메타데이터에서 이를 지정한 가장 가까운 상위 항목에서 생성됩니다.
CoerceValueCallback 구현이 바뀌었습니다. 새 CoerceValueCallback을 추가하면 해당 콜백은 메타데이터에 저장됩니다. 재정의에서 CoerceValueCallback을 지정하지 않으면 CoerceValueCallback 값은 메타데이터에서 이를 지정한 가장 가까운 상위 항목의 참조로 승격됩니다.
속성 시스템 동작은 직접 메타데이터의 CoerceValueCallback만 호출되는 것입니다. 계층 구조에서 다른 CoerceValueCallback 구현에 대한 참조는 보존되지 않습니다.

이 동작은 Merge에 의해 구현되며 파생된 메타데이터 클래스에서 재정의할 수 있습니다.

연결된 속성 메타데이터 재정의

WPF에서 연결된 속성은 종속성 속성으로 구현됩니다. 즉, 이러한 속성에는 개별 클래스에서 재정의할 수 있는 속성 메타데이터도 있습니다. WPF의 연결된 속성에 대한 범위 지정 고려 사항은 일반적으로 모든 DependencyObject에는 연결된 속성을 설정할 수 있다는 것입니다. 따라서 모든 DependencyObject 파생 클래스는 클래스의 인스턴스에 설정된 대로 연결된 속성에 대한 메타데이터를 재정의할 수 있습니다. 기본값, 콜백 또는 WPF 프레임워크 수준 특성 보고 속성을 재정의할 수 있습니다. 연결된 속성이 클래스의 인스턴스에서 설정된 경우 해당 속성 메타데이터 재정의 특성이 적용됩니다. 예를 들어 재정의 값이 클래스의 인스턴스에서 연결된 속성의 값으로 보고되도록 속성이 다르게 설정되지 않을 때마다 기본값을 재정의할 수 있습니다.

참고

Inherits 속성은 연결된 속성과 관련이 없습니다.

기존 종속성 속성의 소유자로 클래스 추가

클래스는 AddOwner 메서드를 사용하여 자신을 이미 등록된 종속성 속성의 소유자로 추가할 수 있습니다. 이렇게 하면 클래스에서 처음에 다른 형식으로 등록된 종속성 속성을 사용할 수 있습니다. 일반적으로 추가하는 클래스는 해당 종속성 속성을 소유자로 처음 등록한 형식의 파생 클래스가 아닙니다. 효과적으로 이렇게 하면 동일한 실제 클래스 계층 구조에 원래 소유자 클래스와 추가하는 클래스가 없어도 클래스와 해당 파생 클래스에서 종속성 속성 구현을 "상속"할 수 있습니다. 또한 추가하는 클래스와 모든 파생 클래스도 원래 종속성 속성에 대해 형식별 메타데이터를 제공할 수 있습니다.

추가하는 클래스는 코드와 태그에 모두 노출하여 종속성 속성을 속성 시스템의 전체 참가자로 만들려면 속성 시스템 유틸리티 메서드를 통해 자신을 소유자로 추가할 뿐만 아니라 클래스 자체에 추가 public 멤버를 선언해야 합니다. 새 사용자 지정 종속성 속성을 정의하는 클래스와 마찬가지로 기존 종속성 속성을 추가하는 클래스는 해당 종속성 속성에 대한 개체 모델을 노출하는 한 동일한 책임이 있습니다. 첫 번째로 노출할 멤버는 종속성 속성 식별자 필드입니다. 이 필드는 AddOwner 호출의 반환 값에 할당되는 DependencyProperty 형식의 public static readonly 필드여야 합니다. 정의할 두 번째 멤버는 CLR(공용 언어 런타임) “래퍼” 속성입니다. 래퍼를 사용하면 코드에서 종속성 속성을 훨씬 더 편리하게 조작할 수 있습니다. 매번 SetValue를 호출할 필요가 없으며 래퍼 자체에서 한 번만 호출하면 됩니다. 래퍼는 사용자 지정 종속성 속성을 등록할 때의 구현 방법과 동일하게 구현됩니다. 종속성 속성 구현에 대한 자세한 내용은 사용자 지정 종속성 속성 및 종속성 속성의 소유자 형식 추가를 참조하세요.

AddOwner 및 연결된 속성

소유자 클래스에 의해 연결된 속성으로 정의되는 종속성 속성에 대해 AddOwner를 호출할 수 있습니다. 일반적으로 이 작업은 이전에 연결된 속성을 연결되지 않은 종속성 속성으로 노출하기 위해 수행합니다. 그런 다음 AddOwner 반환 값을 public static readonly 필드로 노출하여 종속성 속성 식별자로 사용하고 속성이 멤버 테이블에 나타나고 클래스에서 연결되지 않은 속성 사용을 지원하도록 적절한 “래퍼” 속성을 정의합니다.