DependencyPropertyKey DependencyPropertyKey DependencyPropertyKey DependencyPropertyKey Class

정의

읽기 전용 종속성 속성에 대해 제한적인 쓰기 권한을 제공하기 위한 종속성 속성 식별자를 제공합니다.Provides a dependency property identifier for limited write access to a read-only dependency property.

public ref class DependencyPropertyKey sealed
public sealed class DependencyPropertyKey
type DependencyPropertyKey = class
Public NotInheritable Class DependencyPropertyKey
상속
DependencyPropertyKeyDependencyPropertyKeyDependencyPropertyKeyDependencyPropertyKey

예제

다음 예에서는 읽기 전용 종속성 속성을 등록 하 고 다른 클래스 멤버에 대 한 두 가지 용도로 키를 사용 합니다: get "래퍼"를 구현 하 고 계산을 기반으로 값을 설정 하는 보호 된 확인 작업에 대 한 식별자로 다른 속성 값입니다.The following example registers a read-only dependency property, and also uses the key for two purposes in other class members: implementing the get "wrapper", and as the identifier for a protected determination operation that sets the value based on calculations of other property values.

internal static readonly DependencyPropertyKey AquariumSizeKey = DependencyProperty.RegisterReadOnly(
  "AquariumSize",
  typeof(double),
  typeof(Aquarium),
  new PropertyMetadata(double.NaN)
);
public static readonly DependencyProperty AquariumSizeProperty =
  AquariumSizeKey.DependencyProperty;
public double AquariumSize
{
  get { return (double)GetValue(AquariumSizeProperty); }
}
Friend Shared ReadOnly AquariumSizeKey As DependencyPropertyKey = DependencyProperty.RegisterReadOnly("AquariumSize", GetType(Double), GetType(Aquarium), New PropertyMetadata(Double.NaN))
Public Shared ReadOnly AquariumSizeProperty As DependencyProperty = AquariumSizeKey.DependencyProperty
Public ReadOnly Property AquariumSize() As Double
    Get
        Return CDbl(GetValue(AquariumSizeProperty))
    End Get
End Property

설명

DependencyPropertyKey 인스턴스 메서드를 사용 하 여 종속성 속성 등록 호출의 반환 값으로 얻습니다 RegisterReadOnly 또는 RegisterAttachedReadOnly합니다.DependencyPropertyKey instances are obtained as the return value of a dependency property registration call using the methods RegisterReadOnly or RegisterAttachedReadOnly.

종속성 속성을 등록 하는 형식을 사용할 수는 DependencyPropertyKey 에 대 한 호출 SetValueClearValue 클래스 논리의 일부로 속성의 값을 조정 하는 합니다.The types that register a dependency property can use the DependencyPropertyKey in calls to SetValue and ClearValue that adjust the property's value as part of class logic. 키의 액세스 수준을 허용 하는 경우 관련된 클래스도 사용할 수는 키와 종속성 속성입니다.If permitted by the access level of the key, related classes can use the key and the dependency property also. 예를 들어 내부로 키를 선언할 수 있으며 동일한 어셈블리 내의 다른 형식 종속성 속성을 설정할 수도 있습니다.For instance, you can declare the key as internal, and other types within the same assembly can also set that dependency property.

DependencyPropertyKey 반환 된 읽기 전용 종속성 속성 등록 해야 하지 public으로 설정 하기 때문에 키가 노출 속성을 설정할 수 있는, 따라서 읽기 전용 종속성 속성으로 등록 하는 시점을 더 어렵게 만든다는 점입니다.The DependencyPropertyKey returned by read-only dependency property registration should not be made public, because exposing the key makes the property settable, thus defeating the point of registering it as a read-only dependency property. 또한 키가 노출 간에 불일치가 발생 사용할 수 있는 종속성 속성 동작 및 해당 CLR(공용 언어 런타임)common language runtime (CLR) 은 잘못 된 클래스 디자인 속성 래퍼 구현 합니다.Also, exposing the key causes a mismatch between the available dependency property behaviors and its CLR(공용 언어 런타임)common language runtime (CLR) property wrapper implementations, which is bad class design.

자체 키를 노출 하는 대신 노출 해야 합니다 DependencyProperty 값을 DependencyPropertyKey 으로 public static readonly DependencyProperty 클래스에서.Instead of exposing the key itself, you should instead expose the DependencyProperty value of the DependencyPropertyKey as a public static readonlyDependencyProperty on your class. 이 통해 반환할 속성을 올바른 종속성 속성 식별자를 특정 로컬 설정 값을 열거 하는 등 속성 시스템 작업 수 있습니다.This enables the property to return a valid dependency property identifier for certain property system operations such as enumerating locally set values. 그러나 가져온 따라서 식별자 없는의 전체 기능을 DependencyProperty 많은 속성 시스템 작업에 대 한 합니다.However, the identifier thus obtained does not have the full capabilities of a DependencyProperty for many property system operations.

속성

DependencyProperty DependencyProperty DependencyProperty DependencyProperty

이 특수 읽기 전용 종속성 속성 식별자와 연결된 종속성 속성 식별자를 가져옵니다.Gets the dependency property identifier associated with this specialized read-only dependency property identifier.

메서드

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
OverrideMetadata(Type, PropertyMetadata) OverrideMetadata(Type, PropertyMetadata) OverrideMetadata(Type, PropertyMetadata) OverrideMetadata(Type, PropertyMetadata)

이 종속성 속성 식별자가 나타내는 읽기 전용 종속성 속성의 메타데이터를 재정의합니다.Overrides the metadata of a read-only dependency property that is represented by this dependency property identifier.

ToString() ToString() ToString() ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(Inherited from Object)

적용 대상

추가 정보