Windows 앱
콘텐츠의 테이블 축소
콘텐츠의 테이블 확장
이 문서는 수동으로 번역한 것입니다. 원본 텍스트를 보려면 포인터를 문서의 문장 위로 올리십시오.
번역
원본
정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

DependencyObject 클래스

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

네임스페이스:  System.Windows
어셈블리:  WindowsBase(WindowsBase.dll)
XAML의 XMLNS: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

[NameScopePropertyAttribute("NameScope", typeof(NameScope))]
public class DependencyObject : DispatcherObject
<DependencyObject .../>

DependencyObject 형식에서는 다음과 같은 멤버를 노출합니다.

  이름설명
Public 메서드DependencyObject DependencyObject 클래스의 새 인스턴스를 초기화합니다.
위쪽

  이름설명
Public 속성DependencyObjectType 이 인스턴스의 CLR 형식을 래핑하는DependencyObjectType를 가져옵니다.
Public 속성DispatcherDispatcherObject와 연결된 Dispatcher를 가져옵니다. (DispatcherObject에서 상속됨)
Public 속성IsSealed이 인스턴스가 현재 봉인되어 있는지(읽기 전용인지) 여부를 나타내는 값을 가져옵니다.
위쪽

  이름설명
Public 메서드CheckAccess호출 스레드가 이 DispatcherObject에 액세스할 수 있는지 여부를 확인합니다. (DispatcherObject에서 상속됨)
Public 메서드ClearValue(DependencyProperty)속성의 로컬 값을 지웁니다. 지울 속성은 DependencyProperty 식별자로 지정됩니다.
Public 메서드ClearValue(DependencyPropertyKey)읽기 전용 속성의 로컬 값을 지웁니다. 지울 속성은 DependencyPropertyKey에서 지정됩니다.
Public 메서드CoerceValue지정된 종속성 속성 값을 강제 변환합니다. 이 작업은 호출하는 DependencyObject에 있는 종속성 속성의 속성 메타데이터에 지정되어 있는 CoerceValueCallback 함수를 호출하여 수행합니다.
Public 메서드Equals제공된 DependencyObject가 현재 DependencyObject에 해당하는지 여부를 확인합니다. (Object.Equals(Object)을(를) 재정의함)
Protected 메서드Finalize 개체가 가비지 수집자에서 회수되기 전에, 해당 개체에서 리소스를 해제하고 다른 정리 작업을 수행할 수 있게 합니다. (Object에서 상속됨)
Public 메서드GetHashCodeDependencyObject의 해시 코드를 가져옵니다. (Object.GetHashCode()을(를) 재정의함)
Public 메서드GetLocalValueEnumeratorDependencyObject에 대해 로컬로 값을 설정한 종속성 속성을 확인하기 위한 특수 열거자를 만듭니다.
Public 메서드GetType현재 인스턴스의 Type을 가져옵니다. (Object에서 상속됨)
Public 메서드GetValueDependencyObject 인스턴스에서 종속성 속성의 현재 유효 값을 반환합니다.
Public 메서드InvalidateProperty지정된 종속성 속성의 유효 값을 다시 계산합니다.
Protected 메서드MemberwiseClone현재 Object의 단순 복사본을 만듭니다. (Object에서 상속됨)
Protected 메서드OnPropertyChangedDependencyObject에서 종속성 속성의 유효 값이 업데이트될 때마다 호출됩니다. 변경된 특정 종속성 속성은 이벤트 데이터에서 보고됩니다.
Public 메서드ReadLocalValue종속성 속성의 로컬 값(있는 경우)을 반환합니다.
Public 메서드SetCurrentValue속성의 값 소스를 변경하지 않고 종속성 속성의 값을 설정합니다.
Public 메서드SetValue(DependencyProperty, Object)해당 종속성 속성 식별자로 지정되는 종속성 속성의 로컬 값을 설정합니다.
Public 메서드SetValue(DependencyPropertyKey, Object)종속성 속성의 DependencyPropertyKey 식별자로 지정되는 읽기 전용 종속성 속성의 로컬 값을 설정합니다.
Protected 메서드ShouldSerializePropertyserialization 프로세스를 통해 제공된 종속성 속성의 값을 serialize해야 하는지 여부를 나타내는 값을 반환합니다.
Public 메서드ToString현재 개체를 나타내는 문자열을 반환합니다. (Object에서 상속됨)
Public 메서드VerifyAccess호출 스레드에서 이 DispatcherObject에 액세스할 수 있는지 확인합니다. (DispatcherObject에서 상속됨)
위쪽

DependencyObject 클래스는 대부분의 해당 파생 클래스에서 Windows Presentation Foundation (WPF) 속성 시스템 서비스를 사용하도록 설정합니다.

속성 시스템의 기본 기능은 속성 값을 계산하고 변경된 값에 대한 시스템 알림을 제공하는 것입니다. 속성 시스템에 참가하는 다른 주요 클래스는 DependencyProperty입니다. DependencyProperty는 속성 시스템에 종속성 속성을 등록할 수 있도록 하며 각 종속성 속성에 대한 ID 및 정보를 제공합니다. 반면 기본 클래스인 DependencyObject는 개체가 종속성 속성을 사용할 수 있도록 합니다.

DependencyObject 서비스 및 특성에는 다음이 포함됩니다.

  • 종속성 속성 호스팅 지원. Register 메서드를 호출하고 메서드의 반환 값을 클래스에 공용 상태 필드로 저장하여 종속성 속성을 등록합니다.

  • 연결된 속성 호스팅 지원. RegisterAttached 메서드를 호출하고 메서드의 반환 값을 클래스에 읽기 전용 공용 상태 필드로 저장하여 연결된 속성을 등록합니다. 추가 멤버 요구 사항도 있습니다. 이 항목은 연결된 속성에 대한 WPF 관련 구현을 나타냅니다. 자세한 내용은 연결된 속성 개요을 참조하십시오. 연결된 속성은 DependencyObject에서 파생되는 모든 클래스에 대해 설정할 수 있습니다.

  • DependencyObject 에 있는 모든 종속성 속성의 값에 대해 유틸리티 메서드를 가져오거나 설정하거나 지웁니다.

  • 종속성 속성 또는 연결된 속성의 메타데이터, 강제 값 지원, 속성 변경 알림 및 재정의 콜백입니다. 또한 DependencyObject 클래스를 사용하면 종속성 속성에 대해 사용자별 속성 메타데이터를 활용할 수 있습니다.

  • ContentElement , Freezable 또는 Visual에서 파생되는 클래스의 공통 기본 클래스입니다. 또 다른 기본 요소 클래스인 UIElement에는 Visual을 포함하는 클래스 계층 구조가 있습니다.

다음 예제에서는 DependencyObject에서 파생하여 새 추상 클래스를 만듭니다. 이렇게 만든 클래스는 연결된 속성을 등록하며 해당 연결된 속성에 대한 지원 멤버를 포함합니다.


public abstract class AquariumObject3 : DependencyObject
{
    public enum Bouyancy
    {
        Floats,
        Sinks,
        Drifts
    }
    public static readonly DependencyProperty BouyancyProperty = DependencyProperty.RegisterAttached(
      "Bouyancy",
      typeof(Bouyancy),
      typeof(AquariumObject3),
      new FrameworkPropertyMetadata(Bouyancy.Floats, FrameworkPropertyMetadataOptions.AffectsArrange),
      new ValidateValueCallback(ValidateBouyancy)
    );
    public static void SetBouyancy(UIElement element, Bouyancy value)
    {
        element.SetValue(BouyancyProperty, value);
    }
    public static Bouyancy GetBouyancy(UIElement element)
    {
        return (Bouyancy)element.GetValue(BouyancyProperty);
    }
    private static bool ValidateBouyancy(object value)
    {
        Bouyancy bTest = (Bouyancy) value;
        return (bTest == Bouyancy.Floats || bTest == Bouyancy.Drifts || bTest==Bouyancy.Sinks);
    }
    public static readonly DependencyProperty IsDirtyProperty = DependencyProperty.Register(
      "IsDirty",
      typeof(Boolean),
      typeof(AquariumObject3)
    );
}


.NET Framework

4, 3.5, 3.0에서 지원

.NET Framework Client Profile

4, 3.5 SP1에서 지원

Windows 7, Windows Vista SP1 이상, Windows XP SP3, Windows Server 2008(Server Core는 지원되지 않음), Windows Server 2008 R2(Server Core는 SP1 이상에서 지원됨), Windows Server 2003 SP2

.NET Framework에서 모든 플랫폼의 전체 버전을 지원하지는 않습니다. 지원되는 버전의 목록을 보려면 .NET Framework 시스템 요구 사항을 참조하십시오.

이 형식의 모든 공용 static(Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 인터페이스 멤버는 스레드로부터 안전하지 않습니다.

커뮤니티 추가 항목

표시:
© 2016 Microsoft