다음을 통해 공유

DependencyProperty 클래스

  • 참조

정의

네임스페이스:
Microsoft.UI.Xaml
편집

종속성 속성 시스템에 등록된 종속성 속성을 나타냅니다. 종속성 속성은 값 식, 데이터 바인딩, 애니메이션 및 속성 변경 알림을 지원합니다. DependencyProperty 값이 종속성 속성의 식별자 역할을 하는 방법에 대한 자세한 내용은 종 속성 속성 개요를 참조하세요.

public ref class DependencyProperty sealed
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DependencyProperty final
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class DependencyProperty
Public NotInheritable Class DependencyProperty
상속
Object Platform::Object IInspectable DependencyProperty
특성
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

예제

이 예제에서는 클래스의 공용 정적 멤버로 설정 되는 기본 사용을 DependencyProperty 보여 줍니다. 이 작업은 Register 를 호출하고 반환 값을 클래스의 멤버로 저장하여 수행됩니다. 자세한 예제는 사용자 지정 종속성 속성을 참조하세요.

public class Fish : Control
{
    public static readonly DependencyProperty SpeciesProperty =
    DependencyProperty.Register(
    "Species",
    typeof(String),
    typeof(Fish), null
    );
    public string Species
    {
        get { return (string)GetValue(SpeciesProperty); }
        set { SetValue(SpeciesProperty, (string)value); }
    }
}

Visual C++ 구성 요소 확장(C++/CX) 예제는 Microsoft .NET 예제와 완전히 다르게 고려되어야 하며 여러 코드 파일을 포함하므로 여기에 표시되지 않습니다. 사용자 지정 종속성 속성의 예제를 참조하세요.

설명

종속성 속성 개념은 종속성 속성 개요 항목에서 자세히 설명합니다.

의 DependencyProperty 인스턴스는 종종 설명서에서 종속성 속성 식별자로 참조됩니다. 식별자는 특정 DependencyObject 소유자 유형에 등록된 종속성 속성을 참조하는 방법을 제공합니다. 소유자 형식이 속성을 등록하면 소유자 형식은 instance 소유자 클래스의 정적 멤버인 식별자로 노출 DependencyProperty 합니다.

소유자 DependencyObject 는 종속성 속성에 대한 속성 저장소를 제공합니다. 코드에서 종속성 속성을 사용하는 경우 SetValue와 같은 속성 시스템 메서드 호출에 대한 입력으로 식별자를 사용할 DependencyProperty 수 있습니다. 그러나 대부분의 경우 래퍼를 가져오거나 설정하여 종속성 속성을 가져오거나 설정하는 것이 더 간단합니다. 이 개념은 종속성 속성 개요에 설명되어 있습니다.

DependencyProperty 는 Setter 가 속성 값을 지정할 때 사용되는 값을 채우기 위한 XAML 특성 구문에 대한 네이티브 변환을 지원합니다. 이 변환에서는 입력 문자열에 ownerTypeName**.**propertyName 양식을 사용합니다.

참고

이름으로 속성을 지정하는 데 사용할 수도 있고 특정 데이터 및 애니메이션 API에 필요한 관련 구문은 속성 경로 구문입니다. 속성 경로는 속성이 있는 클래스의 구조와 해당 속성의 값을 참조하는 데 사용할 수 있습니다. 자세한 내용은 속성 경로 구문을 참조하세요.

팁

Microsoft .NET 언어(C# 또는 Microsoft Visual Basic)를 사용하여 프로그래밍하는 경우 TypeName 형식은 System.Type으로 프로젝트합니다. C#을 사용하여 프로그래밍할 때는 연산자를 사용하여 형식의 typeofSystem.Type 에 대한 참조를 가져오는 것이 일반적입니다. Microsoft Visual Basic에서 을 사용합니다 GetType. Visual C++ 구성 요소 확장(C++/CX)을 사용하는 경우 TypeName 도우미 구조체를 만들어야 하는 경우 typeid 구성 요소 확장을 사용할 수 있습니다.

Windows 런타임 DependencyObject의 식별자 및 속성 스토리지를 DependencyProperty 사용하여 XAML 연결 속성 언어 기능을 구현합니다. 자세한 내용은 연결된 속성 개요를 참조하세요.

사용자 지정 종속성 속성

사용자 지정 형식의 속성이 값 식, 데이터 바인딩 또는 애니메이션을 지원하도록 하려면 다음 지침에 따라 종속성 속성을 사용하여 속성을 백업해야 합니다.

  • 를 반환하는 Register 메서드를 사용하여 종속성 속성을 등록합니다 DependencyProperty. 종속성 속성 식별자입니다. 이 개체를 클래스에서 액세스 가능한 정적 읽기 전용 속성으로 노출해야 합니다. 규칙에 따라 이 DependencyProperty 식별자 필드의 이름은 "속성"으로 끝나야 합니다.
  • 등록하는 동안 속성에 대한 PropertyMetadata 를 제공하여 속성의 동작을 추가로 정의할 수 있습니다.
  • 속성에 대한 및 set 접근자 제공get: 속성 래퍼이며 모든 호출자에 대한 속성에 대한 액세스를 간소화합니다.

종속성 속성 이름에 대한 XAML 참조

일반적으로 XAML 태그에 설정된 일부 속성은 해당 값으로 사용합니다 DependencyProperty . 예를 들어 XAML에서 Setter.Property 를 설정합니다. XAML에서 이러한 속성을 설정하려면 종속성 속성의 이름을 특성 값으로 지정합니다.

Setter.Property의 경우 종속성 속성 이름을 참조하는 형식은 Setter가 있는 Style의 TargetType으로 이미 범위가 지정되어 있습니다. TargetType 개체의 종속성 속성의 경우 종속성 속성의 간단한 이름을 사용하여 Setter.Property 값을 지정할 수 있습니다. 예를 들어 슬라이더를 대상으로 하는 Style이 있고 Orientation 속성의 스타일을 지정하려는 경우 속성 특성 값은 "Orientation"일 수 있습니다. 종속성 속성이 대상 형식의 더 깊은 상속에 있는 클래스에서 온 경우 단순 이름도 작동합니다. 예를 들어 Style for aSlider에서 Visibility 속성의 스타일을 지정하려면 속성 특성 값 "Visibility"가 작동합니다. 이 경우 표시 유형 은 UIElement에 의해 정의되었지만 슬라이더에 상속됩니다.

Setter.Property를 사용하여 연결된 속성 이름을 참조할 수도 있습니다. 특성 값의 경우 연결된 속성을 XAML에서 특성으로 설정하는 데 사용하는 것처럼 AttachedPropertyOwner.AttachedPropertyName 형식을 사용합니다. 예를 들어 다음은 Style에서 연결된 속성 AutomationProperties.ItemType을 설정하는 Setter입니다.<Setter Property="AutomationProperties.ItemType" Value="Navigation Button"/>

참고

종속성 속성의 이름은 정적 속성 식별자의 이름이 DependencyProperty 아닙니다. 속성이 등록된 이름 문자열이며, Microsoft IntelliSense 및 참조 설명서에 의해 노출될 때 Windows 런타임 프로그래밍에서 해당 속성의 일반적인 사용 이름입니다. 즉, XAML의 Setter.Property 에 대해 지정한 문자열이 "속성"으로 끝나지 않도록 합니다(종속성 속성에 실제로 접미사 "Property"가 포함된 몇 가지 드문 경우는 제외).

코드에서 DependencyProperty (종속성 속성 식별자) 사용

값을 입력 매개 변수로 사용하는 Windows 런타임 속성 시스템의 유틸리티 메서드인 DependencyProperty 여러 메서드가 있습니다. 여기에는 다음이 포함됩니다.

속성

UnsetValue

속성이 존재하지만 속성 시스템 또는 앱 코드에서 설정한 값이 없음을 나타내는 대신 null 속성 시스템에서 사용하는 정적 값을 지정합니다.

메서드

GetMetadata(TypeName)

형식에 등록된 종속성 속성의 속성 메타데이터 값을 검색합니다. 정보를 원하는 형식을 형식 참조로 지정합니다.
Register(String, TypeName, TypeName, PropertyMetadata)

속성에 대해 지정된 속성 이름, 속성 형식, 소유자 유형 및 속성 메타데이터를 사용하여 종속성 속성을 등록합니다. 등록된 종속성 속성을 소유할 DependencyObject 파생 클래스를 정의하거나 초기화할 때 이 메서드를 사용합니다.
RegisterAttached(String, TypeName, TypeName, PropertyMetadata)

속성에 대해 지정된 속성 이름, 속성 형식, 소유자 유형 및 속성 메타데이터를 사용하여 연결된 종속성 속성을 등록합니다.

적용 대상

추가 정보