DependencyProperty 클래스

정의

스타일 지정, 데이터 바인딩, 애니메이션 및 상속과 같은 메서드를 통해 설정할 수 있는 속성을 나타냅니다.

public ref class DependencyProperty sealed
[System.ComponentModel.TypeConverter("System.Windows.Markup.DependencyPropertyConverter, PresentationFramework, Version=3.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, Custom=null")]
public sealed class DependencyProperty
[System.ComponentModel.TypeConverter("System.Windows.Markup.DependencyPropertyConverter, PresentationFramework, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, Custom=null")]
public sealed class DependencyProperty
[<System.ComponentModel.TypeConverter("System.Windows.Markup.DependencyPropertyConverter, PresentationFramework, Version=3.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, Custom=null")>]
type DependencyProperty = class
[<System.ComponentModel.TypeConverter("System.Windows.Markup.DependencyPropertyConverter, PresentationFramework, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, Custom=null")>]
type DependencyProperty = class
Public NotInheritable Class DependencyProperty
상속
DependencyProperty
특성

설명

A DependencyProperty 는 WPF(Windows Presentation Foundation)에서 다음 기능을 지원합니다.

  • 스타일에서 속성을 설정할 수 있습니다. 자세한 내용은 스타일 지정 및 템플릿을 참조하세요.

  • 데이터 바인딩을 통해 속성을 설정할 수 있습니다. 데이터 바인딩 종속성 속성에 대 한 자세한 내용은 참조 하세요. 방법: 두 컨트롤 속성 바인딩합니다.

  • 동적 리소스 참조를 사용 하 여 속성을 설정할 수 있습니다. 자세한 내용은 XAML 리소스를 참조하세요.

  • 속성은 요소 트리의 부모 요소에서 해당 값 작업을 자동으로 상속할 수 있습니다. 자세한 내용은 속성 값 상속을 참조하세요.

  • 속성 애니메이션을 적용할 수 있습니다. 자세한 내용은 애니메이션 개요를 참조하세요.

  • 속성을 변경한 속성의 이전 값 및 속성 값을 강제 변환 될 수 있는 경우에 보고할 수 있습니다. 자세한 내용은 종속성 속성 콜백 및 유효성 검사를 참조하세요.

  • 속성은 속성 값을 변경하려면 레이아웃 시스템이 요소에 대한 시각적 개체를 다시 구성해야 하는지 여부와 같은 정보를 WPF에 보고합니다.

  • 이 속성은 Visual Studio용 WPF 디자이너에서 지원을 받습니다. 예를 들어, 속성을 편집할 수 있습니다 합니다 속성 창입니다.

종속성 속성에 대 한 자세한 내용은 참조 하세요 종속성 속성 개요합니다. 앞의 목록에 기능을 지원 하도록 사용자 지정 형식에서 속성을 원하는 경우에 종속성 속성을 만들어야 합니다. 사용자 지정 종속성 속성을 만드는 방법에 알아보려면 참조 사용자 지정 종속성 속성합니다.

연결된 된 속성은 모든 개체에 연결된 된 속성을 정의 하는 형식 정보를 보고할 수 있도록 하는 속성입니다. WPF에서 DependencyObject 상속되는 모든 형식은 형식이 속성을 정의하는 형식에서 상속되는지 여부에 관계없이 연결된 속성을 사용할 수 있습니다. 연결된 속성은 XAML 언어의 기능입니다. XAML에서 연결된 속성을 설정하려면 ownerType 을 사용합니다. propertyName 구문입니다. 연결된 된 속성의 예로 DockPanel.Dock 속성입니다. 모든 사용할 수 있는 속성을 만들려는 경우 DependencyObject 형식, 연결된 된 속성을 만들어야 합니다. 참조를 만드는 방법을 비롯 하 여 연결 된 속성에 자세히 알아보려면 연결 된 속성 개요합니다.

XAML 특성 사용

<object property="dependencyPropertyName"/>  

또는

<object property="ownerType.dependencyPropertyName"/>  

또는

<object property="attachedPropertyOwnerType.attachedPropertyName"/>  

XAML 값

dependencyPropertyName
지정 하는 문자열을 DependencyProperty.Name 원하는 종속성 속성입니다. 이 올 수 있습니다 XML 네임 스페이스 접두사 속성은 기본 XML 네임 스페이스에 없는 경우 (자세한 내용은 참조 하세요 XAML 네임 스페이스 및 WPF XAML에 대 한 매핑 Namespace.)

ownerType.dependencyPropertyName
점 (.), 종속성 속성의 소유자 형식 지정 하는 문자열 해당 DependencyProperty.Name합니다. ownerType XML 네임 스페이스 접두사 뒤에 올 수도 있습니다. 이 사용량이 바인딩된 스타일 및 템플릿 때문에 컨텍스트를 구문 분석에 대 한 종속성 속성의 소유자를 지정 해야 합니다는 TargetType 아직 알려지지 않은 합니다. 자세한 내용은 스타일 지정 및 템플릿을 참조하세요.

attachedPropertyOwnerType . attachedPropertyName
연결된 된 속성 이름, 점 (.), 연결된 된 속성의 소유자를 지정 하는 문자열입니다. attachedPropertyOwnerType XML 네임 스페이스 접두사 뒤에 올 수도 있습니다.

필드

UnsetValue

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

속성

DefaultMetadata

종속성 속성의 기본 메타데이터를 가져옵니다.

GlobalIndex

종속성 속성을 고유하게 식별하는 내부 생성 값을 가져옵니다.

Name

종속성 속성의 이름을 가져옵니다.

OwnerType

속성 시스템에 종속성 속성을 등록하거나 자체적으로 속성 소유자로 추가한 개체의 형식을 가져옵니다.

PropertyType

종속성 속성에서 값으로 사용하는 형식을 가져옵니다.

ReadOnly

DependencyProperty 인스턴스로 식별되는 종속성 속성이 읽기 전용 종속성 속성인지 여부를 나타내는 값을 가져옵니다.

ValidateValueCallback

종속성 속성의 값 유효성 검사 콜백을 가져옵니다.

메서드

AddOwner(Type)

이미 등록된 종속성 속성의 소유자로 다른 형식을 추가합니다.

AddOwner(Type, PropertyMetadata)

이미 등록된 종속성 속성의 소유자로 다른 형식을 추가하며, 제공된 소유자 형식에 존재하는 종속성 속성에 대한 종속성 속성 메타데이터를 제공합니다.

Equals(Object)

지정된 개체가 현재 개체와 같은지 확인합니다.

(다음에서 상속됨 Object)
GetHashCode()

DependencyProperty의 해시 코드를 반환합니다.

GetMetadata(DependencyObject)

종속성 속성이 지정된 개체 인스턴스에 있을 때 이 종속성 속성의 메타데이터를 반환합니다.

GetMetadata(DependencyObjectType)

종속성 속성이 지정된 형식일 때 이 종속성 속성의 메타데이터를 반환합니다.

GetMetadata(Type)

종속성 속성이 지정된 기존 형식일 경우 이 종속성 속성의 메타데이터를 반환합니다.

GetType()

현재 인스턴스의 Type을 가져옵니다.

(다음에서 상속됨 Object)
IsValidType(Object)

원래 종속성 속성 등록 시 제공된 속성 형식을 기준으로 지정된 값을 이 종속성 속성 형식에 사용할 수 있는지 확인합니다.

IsValidValue(Object)

제공된 값이 속성 형식에 허용되는지 기본 형식 확인을 통해 확인하고, 해당 형식에 허용되는 값 범위에 속하는지도 확인합니다.

MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.

(다음에서 상속됨 Object)
OverrideMetadata(Type, PropertyMetadata)

지정된 형식의 인스턴스에 있는 경우 이 종속성 속성에 대해 대체 메타데이터를 지정하고, 기본 형식에서 상속된 종속성 속성에 존재하는 메타데이터를 재정의합니다.

OverrideMetadata(Type, PropertyMetadata, DependencyPropertyKey)

지정된 형식의 인스턴스에 있을 경우 읽기 전용 종속성 속성에 대해 대체 메타데이터를 제공하여 초기 종속성 속성 등록 시 제공된 메타데이터를 재정의합니다. 예외가 발생하지 않도록 읽기 전용 종속성 속성에 DependencyPropertyKey 를 전달해야 합니다.

Register(String, Type, Type)

지정된 속성 이름, 속성 형식 및 소유자 유형을 사용하여 종속성 속성을 등록합니다.

Register(String, Type, Type, PropertyMetadata)

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

Register(String, Type, Type, PropertyMetadata, ValidateValueCallback)

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

RegisterAttached(String, Type, Type)

지정된 속성 이름, 속성 형식 및 소유자 유형을 사용하여 연결된 속성을 등록합니다.

RegisterAttached(String, Type, Type, PropertyMetadata)

지정된 속성 이름, 속성 형식, 소유자 유형 및 속성 메타데이터에 연결된 속성을 등록합니다.

RegisterAttached(String, Type, Type, PropertyMetadata, ValidateValueCallback)

속성에 대해 지정된 속성 형식, 소유자 유형, 속성 메타데이터 및 값 유효성 검사 콜백에 연결된 속성을 등록합니다.

RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata)

지정된 속성 형식, 소유자 유형 및 속성 메타데이터를 사용하여 읽기 전용 연결된 속성을 등록합니다.

RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata, ValidateValueCallback)

지정된 속성 형식, 소유자 유형, 속성 메타데이터 및 유효성 검사 콜백을 사용하여 읽기 전용 연결된 속성을 등록합니다.

RegisterReadOnly(String, Type, Type, PropertyMetadata)

지정된 속성 형식, 소유자 유형 및 속성 메타데이터를 사용하여 읽기 전용 종속성 속성을 등록합니다.

RegisterReadOnly(String, Type, Type, PropertyMetadata, ValidateValueCallback)

지정된 속성 형식, 소유자 유형, 속성 메타데이터 및 유효성 검사 콜백을 사용하여 읽기 전용 종속성 속성을 등록합니다.

ToString()

종속성 속성의 문자열 표현을 반환합니다.

적용 대상

추가 정보