DependencyProperty 클래스

정의

스타일 지정, 데이터 바인딩, 애니메이션 및 상속과 같은 메서드를 통해 설정할 수 있는 속성을 나타냅니다.Represents a property that can be set through methods such as, styling, data binding, animation, and inheritance.

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

설명

A DependencyProperty 의 다음 기능을 지 원하는 WPF(Windows Presentation Foundation)Windows Presentation Foundation (WPF):A DependencyProperty supports the following capabilities in WPF(Windows Presentation Foundation)Windows Presentation Foundation (WPF):

  • 스타일에서 속성을 설정할 수 있습니다.The property can be set in a style. 자세한 내용은 스타일 지정 및 템플릿을 참조하세요.For more information, see Styling and Templating.

  • 데이터 바인딩을 통해 속성을 설정할 수 있습니다.The property can be set through data binding. 데이터 바인딩 종속성 속성에 대 한 자세한 내용은 참조 하세요. 방법: 두 컨트롤 속성 바인딩합니다.For more information about data binding dependency properties, see How to: Bind the Properties of Two Controls.

  • 동적 리소스 참조를 사용 하 여 속성을 설정할 수 있습니다.The property can be set with a dynamic resource reference. 자세한 내용은 XAML 리소스를 참조하세요.For more information, see XAML Resources.

  • 속성은 요소 트리의 부모 요소에서 해당 값 작업을 자동으로 상속할 수 있습니다.The property can inherit its value automatically from a parent element in the element tree. 자세한 내용은 속성 값 상속을 참조하세요.For more information, see Property Value Inheritance.

  • 속성 애니메이션을 적용할 수 있습니다.The property can be animated. 자세한 내용은 애니메이션 개요를 참조하세요.For more information, see Animation Overview.

  • 속성을 변경한 속성의 이전 값 및 속성 값을 강제 변환 될 수 있는 경우에 보고할 수 있습니다.The property can report when the previous value of the property has been changed and the property value can be coerced. 자세한 내용은 종속성 속성 콜백 및 유효성 검사를 참조하세요.For more information, see Dependency Property Callbacks and Validation.

  • 속성에 대 한 정보를 보고 WPFWPF여부 속성을 변경 해야 요소에 대 한 시각적 개체를 다시 구성 하기 위해 레이아웃 시스템 같은, 합니다.The property reports information to WPFWPF, such as whether changing a property value should require the layout system to recompose the visuals for an element.

  • 속성에서 지원을 받습니다는 WPF Designer for Visual StudioWPF Designer for Visual Studio합니다.The property receives support in the WPF Designer for Visual StudioWPF Designer for Visual Studio. 예를 들어, 속성을 편집할 수 있습니다 합니다 속성 창입니다.For example, the property can be edited in the Properties window.

종속성 속성에 대 한 자세한 내용은 참조 하세요 종속성 속성 개요합니다.To learn more about dependency properties, see Dependency Properties Overview. 앞의 목록에 기능을 지원 하도록 사용자 지정 형식에서 속성을 원하는 경우에 종속성 속성을 만들어야 합니다.If you want properties on your custom types to support the capabilities in the preceding list, you should create a dependency property. 사용자 지정 종속성 속성을 만드는 방법에 알아보려면 참조 사용자 지정 종속성 속성합니다.To learn how to create custom dependency properties, see Custom Dependency Properties.

연결된 된 속성은 모든 개체에 연결된 된 속성을 정의 하는 형식 정보를 보고할 수 있도록 하는 속성입니다.An attached property is a property that enables any object to report information to the type that defines the attached property. WPFWPF에서 상속 되는 모든 형식을 DependencyObject 속성을 정의 하는 형식에서 상속 되었는지에 관계 없이 연결된 된 속성을 사용할 수 있습니다.In WPFWPF, any type that inherits from DependencyObject can use an attached property regardless of whether the type inherits from the type that defines the property. 연결된 된 속성의 기능은 XAMLXAML 언어입니다.An attached property is a feature of the XAMLXAML language. 연결된 된 속성을 설정 하려면 XAMLXAML를 사용 합니다 ownerType. propertyName 구문입니다.To set an attached property in XAMLXAML, use the ownerType.propertyName syntax. 연결된 된 속성의 예로 DockPanel.Dock 속성입니다.An example of an attached property is the DockPanel.Dock property. 모든 사용할 수 있는 속성을 만들려는 경우 DependencyObject 형식, 연결된 된 속성을 만들어야 합니다.If you want to create a property that can be used on all DependencyObject types, then you should create an attached property. 참조를 만드는 방법을 비롯 하 여 연결 된 속성에 자세히 알아보려면 연결 된 속성 개요합니다.To learn more about attached properties, including how to create them, see Attached Properties Overview.

XAML 특성 사용XAML Attribute Usage

<object property="dependencyPropertyName"/>  

또는-or-

<object property="ownerType.dependencyPropertyName"/>  

또는-or-

<object property="attachedPropertyOwnerType.attachedPropertyName"/>  

XAML 값XAML Values

dependencyPropertyName
지정 하는 문자열을 DependencyProperty.Name 원하는 종속성 속성입니다.A string that specifies the DependencyProperty.Name of the desired dependency property. 이 올 수 있습니다 XML 네임 스페이스 접두사 속성은 기본 XML 네임 스페이스에 없는 경우 (자세한 내용은 참조 하세요 XAML 네임 스페이스 및 WPF XAML에 대 한 매핑 Namespace.)This can be preceded by an XML namespace prefix if the property is not in the default XML namespace (for details, see XAML Namespaces and Namespace Mapping for WPF XAML.)

ownerType.dependencyPropertyNameownerType.dependencyPropertyName
점 (.), 종속성 속성의 소유자 형식 지정 하는 문자열 해당 DependencyProperty.Name합니다.A string that specifies an owner type of a dependency property, a dot (.), then the DependencyProperty.Name. ownerType XML 네임 스페이스 접두사 뒤에 올 수도 있습니다.ownerType can also be preceded by an XML namespace prefix. 이 사용량이 바인딩된 스타일 및 템플릿 때문에 컨텍스트를 구문 분석에 대 한 종속성 속성의 소유자를 지정 해야 합니다는 TargetType 아직 알려지지 않은 합니다.This usage is particular to late-bound styles and templates, where the owner of the dependency property must be specified for parsing context because the TargetType is not yet known. 자세한 내용은 스타일 지정 및 템플릿을 참조하세요.For more information, see Styling and Templating.

attachedPropertyOwnerType 의 해시 코드를 반환합니다.attachedPropertyOwnerType . attachedPropertyName
연결된 된 속성 이름, 점 (.), 연결된 된 속성의 소유자를 지정 하는 문자열입니다.A string that specifies the owner of an attached property, a dot (.), then the attached property name. attachedPropertyOwnerType XML 네임 스페이스 접두사 뒤에 올 수도 있습니다.attachedPropertyOwnerType can also be preceded by an XML namespace prefix.

필드

UnsetValue

속성이 있지만 속성 시스템에 의해 값이 설정되지 않았음을 나타내기 위해 WPFWPF 속성 시스템에서 null 대신 사용하는 정적 값을 지정합니다.Specifies a static value that is used by the WPFWPF property system rather than null to indicate that the property exists, but does not have its value set by the property system.

속성

DefaultMetadata

종속성 속성의 기본 메타데이터를 가져옵니다.Gets the default metadata of the dependency property.

GlobalIndex

종속성 속성을 고유하게 식별하는 내부 생성 값을 가져옵니다.Gets an internally generated value that uniquely identifies the dependency property.

Name

종속성 속성의 이름을 가져옵니다.Gets the name of the dependency property.

OwnerType

속성 시스템에 종속성 속성을 등록하거나 자체적으로 속성 소유자로 추가한 개체의 형식을 가져옵니다.Gets the type of the object that registered the dependency property with the property system, or added itself as owner of the property.

PropertyType

종속성 속성에서 값으로 사용하는 형식을 가져옵니다.Gets the type that the dependency property uses for its value.

ReadOnly

DependencyProperty 인스턴스로 식별되는 종속성 속성이 읽기 전용 종속성 속성인지 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether the dependency property identified by this DependencyProperty instance is a read-only dependency property.

ValidateValueCallback

종속성 속성의 값 유효성 검사 콜백을 가져옵니다.Gets the value validation callback for the dependency property.

메서드

AddOwner(Type)

이미 등록된 종속성 속성의 소유자로 다른 형식을 추가합니다.Adds another type as an owner of a dependency property that has already been registered.

AddOwner(Type, PropertyMetadata)

이미 등록된 종속성 속성의 소유자로 다른 형식을 추가하며, 제공된 소유자 형식에 존재하는 종속성 속성에 대한 종속성 속성 메타데이터를 제공합니다.Adds another type as an owner of a dependency property that has already been registered, providing dependency property metadata for the dependency property as it will exist on the provided owner type.

Equals(Object)

지정한 개체와 현재 개체가 같은지 여부를 확인합니다.Determines whether the specified object is equal to the current object.

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

DependencyProperty의 해시 코드를 반환합니다.Returns a hash code for this DependencyProperty.

GetMetadata(DependencyObject)

종속성 속성이 지정된 개체 인스턴스에 있을 때 이 종속성 속성의 메타데이터를 반환합니다.Returns the metadata for this dependency property as it exists on the specified object instance.

GetMetadata(DependencyObjectType)

종속성 속성이 지정된 형식일 때 이 종속성 속성의 메타데이터를 반환합니다.Returns the metadata for this dependency property as it exists on a specified type.

GetMetadata(Type)

종속성 속성이 지정된 기존 형식일 경우 이 종속성 속성의 메타데이터를 반환합니다.Returns the metadata for this dependency property as it exists on a specified existing type.

GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

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

원래 종속성 속성 등록 시 제공된 속성 형식을 기준으로 지정된 값을 이 종속성 속성 형식에 사용할 수 있는지 확인합니다.Determines whether a specified value is acceptable for this dependency property's type, as checked against the property type provided in the original dependency property registration.

IsValidValue(Object)

제공된 값이 속성 형식에 허용되는지 기본 형식 확인을 통해 확인하고, 해당 형식에 허용되는 값 범위에 속하는지도 확인합니다.Determines whether the provided value is accepted for the type of property through basic type checking, and also potentially if it is within the allowed range of values for that type.

MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

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

지정된 형식의 인스턴스에 있는 경우 이 종속성 속성에 대해 대체 메타데이터를 지정하고, 기본 형식에서 상속된 종속성 속성에 존재하는 메타데이터를 재정의합니다.Specifies alternate metadata for this dependency property when it is present on instances of a specified type, overriding the metadata that existed for the dependency property as it was inherited from base types.

OverrideMetadata(Type, PropertyMetadata, DependencyPropertyKey)

지정된 형식의 인스턴스에 있을 경우 읽기 전용 종속성 속성에 대해 대체 메타데이터를 제공하여 초기 종속성 속성 등록 시 제공된 메타데이터를 재정의합니다.Supplies alternate metadata for a read-only dependency property when it is present on instances of a specified type, overriding the metadata that was provided in the initial dependency property registration. 예외가 발생하지 않도록 읽기 전용 종속성 속성에 DependencyPropertyKey를 전달해야 합니다.You must pass the DependencyPropertyKey for the read-only dependency property to avoid raising an exception.

Register(String, Type, Type)

지정된 속성 이름, 속성 형식 및 소유자 유형을 사용하여 종속성 속성을 등록합니다.Registers a dependency property with the specified property name, property type, and owner type.

Register(String, Type, Type, PropertyMetadata)

지정된 속성 이름, 속성 형식, 소유자 유형 및 속성 메타데이터를 사용하여 종속성 속성을 등록합니다.Registers a dependency property with the specified property name, property type, owner type, and property metadata.

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

속성에 대해 지정된 속성 이름, 속성 형식, 소유자 유형, 속성 메타데이터 및 값 유효성 검사 콜백을 사용하여 종속성 속성을 등록합니다.Registers a dependency property with the specified property name, property type, owner type, property metadata, and a value validation callback for the property.

RegisterAttached(String, Type, Type)

지정된 속성 이름, 속성 형식 및 소유자 유형을 사용하여 연결된 속성을 등록합니다.Registers an attached property with the specified property name, property type, and owner type.

RegisterAttached(String, Type, Type, PropertyMetadata)

지정된 속성 이름, 속성 형식, 소유자 유형 및 속성 메타데이터에 연결된 속성을 등록합니다.Registers an attached property with the specified property name, property type, owner type, and property metadata.

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

속성에 대해 지정된 속성 형식, 소유자 유형, 속성 메타데이터 및 값 유효성 검사 콜백에 연결된 속성을 등록합니다.Registers an attached property with the specified property type, owner type, property metadata, and value validation callback for the property.

RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata)

지정된 속성 형식, 소유자 유형 및 속성 메타데이터를 사용하여 읽기 전용 연결된 속성을 등록합니다.Registers a read-only attached property, with the specified property type, owner type, and property metadata.

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

지정된 속성 형식, 소유자 유형, 속성 메타데이터 및 유효성 검사 콜백을 사용하여 읽기 전용 연결된 속성을 등록합니다.Registers a read-only attached property, with the specified property type, owner type, property metadata, and a validation callback.

RegisterReadOnly(String, Type, Type, PropertyMetadata)

지정된 속성 형식, 소유자 유형 및 속성 메타데이터를 사용하여 읽기 전용 종속성 속성을 등록합니다.Registers a read-only dependency property, with the specified property type, owner type, and property metadata.

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

지정된 속성 형식, 소유자 유형, 속성 메타데이터 및 유효성 검사 콜백을 사용하여 읽기 전용 종속성 속성을 등록합니다.Registers a read-only dependency property, with the specified property type, owner type, property metadata, and a validation callback.

ToString()

종속성 속성의 문자열 표현을 반환합니다.Returns the string representation of the dependency property.

적용 대상

추가 정보