DependencyProperty 클래스

정의

네임스페이스:

System.Windows

어셈블리:

WindowsBase.dll

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

public ref class DependencyProperty sealed

[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=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, Custom=null")>]
type DependencyProperty = class

Public NotInheritable Class DependencyProperty

상속

Object

DependencyProperty

특성

TypeConverterAttribute

설명

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 네임스페이스 접두사 앞에 올 수 있습니다(자세한 내용은 WPF XAML대한 XAML 네임스페이스 및 네임스페이스 매핑 참조).

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()	종속성 속성의 문자열 표현을 반환합니다.

추가 정보

• DependencyObject
• DependencyPropertyHelper