다음을 통해 공유

DependencyObject 클래스

  • 참조

정의

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

종속성 속성 시스템에 참가하는 개체를 나타냅니다.

public ref class DependencyObject
/// [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 DependencyObject
[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 class DependencyObject
Public Class DependencyObject
상속
Object Platform::Object IInspectable DependencyObject
파생
특성
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

예제

이 예제에서는 에서 DependencyObject파생되는 클래스를 정의하고 식별자 필드와 함께 연결된 속성을 정의합니다. 이 클래스의 시나리오는 다른 UI 요소가 XAML에서 설정할 수 있는 연결된 속성을 선언하는 서비스 클래스입니다. 서비스는 런타임에 해당 UI 요소의 연결된 속성 값에 대해 잠재적으로 작동합니다.

public abstract class AquariumServices : DependencyObject
{
    public enum Buoyancy { Floats, Sinks, Drifts }

    public static readonly DependencyProperty BuoyancyProperty = DependencyProperty.RegisterAttached(
      "Buoyancy",
      typeof(Buoyancy),
      typeof(AquariumServices),
      new PropertyMetadata(Buoyancy.Floats)
    );
    public static void SetBuoyancy(DependencyObject element, Buoyancy value)
    {
        element.SetValue(BuoyancyProperty, value);
    }
    public static Buoyancy GetBuoyancy(DependencyObject element)
    {
        return (Buoyancy)element.GetValue(BuoyancyProperty);
    }
}

public static bool ClearSetProperty(DependencyObject targetObject, DependencyProperty targetDP)
{
    if (targetObject == null || targetDP == null)
    {
        throw new ArgumentNullException();
    }
    object localValue = targetObject.ReadLocalValue(targetDP);
    if (localValue == DependencyProperty.UnsetValue)
    {
        return false;
    }
    else
    {
        targetObject.ClearValue(targetDP);
        return true;
    }
}

이 예제에서는 간단한 종속성 속성 선언을 보여줍니다. GetValue 호출은 새 종속성 속성의 get 속성 래퍼에 대한 접근자 구현 전체를 구성합니다. SetValue에 대한 호출은 접근자 구현 전체를 set 구성합니다. 자세한 예제는 사용자 지정 종속성 속성을 참조하세요.

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); }
    }
}

설명

클래스는 DependencyObject 많은 파생 클래스에서 종속성 속성 시스템 서비스를 사용하도록 설정하고 UIElement, Geometry, FrameworkTemplate, Style 및 ResourceDictionary와 같은 많은 중요한 UI 관련 클래스의 즉각적인 기본 클래스입니다. 종속성 속성을 지원하는 방법에 DependencyObject 대한 자세한 내용은 종속성 속성 개요를 참조하세요.

종속성 속성 시스템의 기본 함수는 속성 값을 계산하고 변경된 값에 대한 시스템 알림을 제공하는 것입니다. 종속성 속성 시스템에 참여하는 또 다른 키 클래스는 DependencyProperty입니다. DependencyProperty 를 사용하면 속성 시스템에 종속성 속성을 등록할 수 있는 반면 DependencyObject , 기본 클래스로 개체는 종속성 속성을 사용하고 설정할 수 있습니다.

다음은 DependencyObject에서 제공하거나 지원하는 몇 가지 주목할 만한 서비스 및 특성입니다.

  • 기존 Windows 런타임 종속성 속성에 대한 종속성 속성 호스팅 지원.
  • 사용자 지정 종속성 속성 호스팅 지원. Register 메서드를 호출하고 메서드의 반환 값을 클래스에 공용 정적 속성으로 저장하여 종속성 속성을 등록합니다DependencyObject.
  • 기존 Windows 런타임 연결된 속성에 대한 연결된 속성 호스팅 지원입니다.
  • 사용자 지정 연결된 속성 호스팅 지원. RegisterAttached 메서드를 호출하고 메서드의 반환 값을 클래스에 공용 정적 속성으로 저장하여 연결된 속성 사용에 대한 종속성 속성을 등록합니다.
  • Get 및 Set 유틸리티 메서드는 에 있는 모든 종속성 속성의 값에 대한 메서드입니다 DependencyObject. 사용자 지정 종속성 속성 래퍼 를 정의할 때 이러한 래퍼를 사용하고 기존 래퍼 속성을 사용하는 대신 앱 코드에서 사용할 수도 있습니다.
  • 메타데이터 또는 속성 값(예: GetAnimationBaseValue)을 검사하기 위한 고급 시나리오 유틸리티입니다.
  • 모든 DependencyObject 인스턴스에 대해 Windows 런타임 기본 UI 스레드에 대한 스레드 선호도 적용
  • 고급 스레딩 시나리오에 대한 DispatcherQueue 속성입니다. DispatcherQueue 를 사용하면 을 사용 DependencyObject 하지만 UI 스레드에 없는 작업자 스레드는 UI 스레드를 차단하거나 방해하지 않는 비동기 작업으로 실행을 연기할 수 있으므로 코드를 실행할 수 있습니다. 아래의 "DependencyObject 및 스레딩" 섹션을 참조하세요.
  • 기본 데이터 바인딩 및 스타일 지정을 지원합니다. 속성을 식으로 설정할 수 있도록 하여 개체의 수명 중 나중에 계산할 수 있습니다. 이러한 개념은 종속성 속성 개요에서 자세히 설명합니다. 자세한 내용은 데이터 바인딩을 참조하세요.

DependencyObject 및 스레딩

앱의 현재 창과 연결된 UI 스레드에서 모든 DependencyObject 인스턴스를 만들어야 합니다. 이는 시스템에 의해 적용되며 코드에 두 가지 중요한 의미가 있습니다.

  • 두 DependencyObject 인스턴스의 API를 사용하는 코드는 항상 UI 스레드인 동일한 스레드에서 실행됩니다. 이 시나리오에서는 일반적으로 스레딩 문제가 실행되지 않습니다.
  • 기본 UI 스레드에서 실행되지 않는 코드는 에 UI 스레드에 대한 스레드 선호도만 있으므로 에 직접 DependencyObject 액세스할 DependencyObject 수 없습니다. UI 스레드에서 실행되는 코드만 종속성 속성 값을 변경하거나 읽을 수 있습니다. 예를 들어 .NET 작업 또는 명시적 ThreadPool 스레드로 시작한 작업자 스레드는 종속성 속성을 읽거나 다른 API를 호출할 수 없습니다.

작업자 스레드에서 를 DependencyObject 사용하는 것이 완전히 차단되지는 않습니다. 그러나 앱 UI 스레드와 시스템에서 실행되는 다른 스레드 간의 의도적인 분리를 건너려면 디스패처Queue 개체( DependencyObject.DispatcherQueue 값)를 에서 DependencyObject 가져와야 합니다. 는 DispatcherQueueTryEnqueue 메서드를 노출하여 대기 가능한 코드를 실행합니다. 스레드 간에 액세스를 사용하도록 설정하기 때문에 는 스레드 DependencyObject.DispatcherQueue 간 예외를 throw하지 않고 UI가 아닌 스레드에서 액세스할 수 있는 서브클래스의 유일한 instance API DependencyObject 입니다. 다른 DependencyObject 모든 API는 작업자 스레드 또는 다른 비 UI 스레드에서 호출하려고 하면 예외를 throw합니다.

일반적으로 일반적인 UI 코드에서는 스레딩 문제를 방지할 수 있습니다. 그러나 디바이스는 일반적으로 UI 스레드와 연결되지 않습니다. 디바이스에서 얻은 정보를 사용하여 실시간으로 UI를 업데이트하는 경우 UI를 업데이트할 수 있도록 을 DispatcherQueue 가져와야 하는 경우가 많습니다. 서비스는 서비스에 액세스하는 데 사용하는 코드가 UI 스레드에서 실행되지 않을 수 있는 또 다른 경우입니다.

고유한 DependencyObject 형식을 정의하고 데이터 원본 또는 가 반드시 적절하지 않은 다른 시나리오(개체가 UI와 직접 관련이 없기 때문에)에 사용하려고 하면 관련 스레딩 문제가 발생할 DependencyObject수 있는 DependencyObject 한 가지 코드 시나리오입니다. 예를 들어 프레젠테이션 전에 개체의 값을 변경하거나 디바이스, 서비스 또는 기타 외부 입력에 대한 응답으로 백그라운드 스레드 또는 다른 작업자 스레드를 사용하여 성능 최적화를 시도할 수 있습니다. 시나리오에 대한 종속성 속성이 실제로 필요한지 여부를 평가합니다. 표준 속성이 적절할 수 있습니다.

DependencyObject 파생 클래스

DependencyObject 는 앱 및 해당 XAML UI에 사용하는 프로그래밍 모델의 기본인 몇 가지 즉시 파생된 클래스에 대한 부모 클래스입니다. 다음은 몇 가지 주목할 만한 파생 클래스입니다.

생성자

DependencyObject()

DependencyObject 파생 클래스에 대한 기본 클래스 초기화 동작을 제공합니다.

속성

Dispatcher

항상 Windows 앱 SDK 앱에서 를 반환 null 합니다. 대신 DispatcherQueue 를 사용합니다.
DispatcherQueue

DispatcherQueue 이 개체가 연결된 을 가져옵니다. 는 DispatcherQueue 코드가 비 UI 스레드에 의해 시작되는 경우에도 UI 스레드에서 에 액세스할 DependencyObject 수 있는 기능을 나타냅니다.

메서드

ClearValue(DependencyProperty)

종속성 속성의 로컬 값을 지웁니다.
GetAnimationBaseValue(DependencyProperty)

애니메이션이 활성화되지 않은 경우 적용되는 종속성 속성에 대해 설정된 모든 기본 값을 반환합니다.
GetValue(DependencyProperty)

DependencyObject에서 종속성 속성의 현재 유효 값을 반환합니다.
ReadLocalValue(DependencyProperty)

로컬 값이 설정된 경우 종속성 속성의 로컬 값을 반환합니다.
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)

이 DependencyObject instance 특정 DependencyProperty의 변경 내용을 수신 대기하기 위한 알림 함수를 등록합니다.
SetValue(DependencyProperty, Object)

DependencyObject에서 종속성 속성의 로컬 값을 설정합니다.
UnregisterPropertyChangedCallback(DependencyProperty, Int64)

RegisterPropertyChangedCallback을 호출하여 이전에 등록된 변경 알림을 취소합니다.

적용 대상

추가 정보