DependencyProperty.RegisterAttachedReadOnly 메서드

정의

읽기 전용 연결된 속성을 등록합니다.Registers a read-only attached 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.

RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata)

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

public:
 static System::Windows::DependencyPropertyKey ^ RegisterAttachedReadOnly(System::String ^ name, Type ^ propertyType, Type ^ ownerType, System::Windows::PropertyMetadata ^ defaultMetadata);
public static System.Windows.DependencyPropertyKey RegisterAttachedReadOnly (string name, Type propertyType, Type ownerType, System.Windows.PropertyMetadata defaultMetadata);
static member RegisterAttachedReadOnly : string * Type * Type * System.Windows.PropertyMetadata -> System.Windows.DependencyPropertyKey
Public Shared Function RegisterAttachedReadOnly (name As String, propertyType As Type, ownerType As Type, defaultMetadata As PropertyMetadata) As DependencyPropertyKey

매개 변수

name
String

등록할 종속성 속성의 이름입니다.The name of the dependency property to register.

propertyType
Type

속성의 형식입니다.The type of the property.

ownerType
Type

종속성 속성을 등록하는 소유자 유형입니다.The owner type that is registering the dependency property.

defaultMetadata
PropertyMetadata

종속성 속성의 속성 메타데이터입니다.Property metadata for the dependency property.

반환

DependencyPropertyKey

클래스의 정적 읽기 전용 필드 값을 설정하는 데 사용할 종속성 속성 키로, 나중에 종속성 속성을 참조하는 데 사용됩니다.A dependency property key that should be used to set the value of a static read-only field in your class, which is then used to reference the dependency property later.

설명

이 메서드는 형식을 반환 DependencyPropertyKey반면 RegisterAttached 형식을 반환 DependencyProperty합니다.This method returns the type DependencyPropertyKey, whereas RegisterAttached returns the type DependencyProperty. 일반적으로 읽기 전용 속성을 나타내는 키 되지 공용를 호출 하 여 종속성 속성 값을 설정 하는 키를 사용할 수 있으므로 SetValue(DependencyPropertyKey, Object)합니다.Typically, the keys that represent read-only properties are not made public, because the keys can be used to set the dependency property value by calling SetValue(DependencyPropertyKey, Object). 클래스 디자인 요구 사항에 영향이 있지만의 표시 유형 확인 하 고 액세스를 제한 하려면 일반적으로 좋습니다 DependencyPropertyKey 클래스 또는 애플리케이션 논리의 일부로 종속성 속성을 설정 하는 데 필요한 코드의 부분에 합니다.Your class design will affect your requirements, but it is generally recommended to limit the access and visibility of any DependencyPropertyKey to only those parts of your code that are necessary to set that dependency property as part of class or application logic. 값을 노출 하 여 읽기 전용 종속성 속성에 대 한 종속성 속성 식별자를 노출 하는 것이 좋습니다 DependencyPropertyKey.DependencyProperty 으로 public static readonly 클래스에 필드입니다.It is also recommended that you expose a dependency property identifier for the read-only dependency property, by exposing the value of DependencyPropertyKey.DependencyProperty as a public static readonly field on your class.

연결된 된 속성에 대 한 기본 시나리오에서 사용 하는 중 이므로 읽기 전용으로 연결 된 속성은 드문 경우 XAMLXAML합니다.Read-only attached properties are a rare scenario, because the primary scenario for an attached property is its use in XAMLXAML. Public setter를 하지 않고 연결된 된 속성에 설정할 수 없습니다 XAMLXAML 구문입니다.Without a public setter, an attached property cannot be set in XAMLXAML syntax.

종속성 속성 등록에 대 한 자세한 내용은 참조 하세요. DependencyProperty합니다.For more information on dependency property registration, see DependencyProperty.

종속성 속성 값 상속을 사용 하 여 RegisterAttachedUse RegisterAttached for Value-inheriting Dependency Properties

종속성 속성으로 등록 하는 데 하나의 특정 시나리오는 연결 된 속성 값 상속을 지원입니다.One particular scenario for registering a dependency property as attached is to support property value inheritance. 사용 하 여 종속성 속성 값 상속을 등록 해야 RegisterAttached 클래스는 종속성 속성을 노출 하는 속성 래퍼 접근자를 정의 하는 경우에 및 숨기지 않으려면 제공 하는 Get * 및 집합 * 정적 메서드를 노출 하려면 true를 연결 하는 경우에 접근자 지원 합니다.You should register value-inheriting dependency properties with RegisterAttached even if the class defines property wrapper accessors that expose the dependency property, and even if you do not intend to expose Get* and Set* static methods to provide true attached property support accessors. 속성 값 상속은 연결 되지 않은 종속성 속성에 대 한 작업에 표시 될 수 있지만 런타임 트리의 특정 요소 경계를 통해 연결 되지 않은 속성에 대 한 상속 동작은 정의 되지 않습니다.Although property value inheritance might appear to work for nonattached dependency properties, the inheritance behavior for a nonattached property through certain element boundaries in the runtime tree is undefined. 효과적으로 연결 속성을 등록 속성 시스템에 연결된 된 속성이 전역 속성으로 설정 및 속성 값 상속은 요소 트리에서 모든 경계에 걸쳐 작동 하는 보장 합니다.Registering the property as attached effectively makes the attached property a global property to the property system, and assures that property value inheritance works across all boundaries in an element tree. 항상 사용 하 여 RegisterAttached 지정 하는 속성을 등록 하려면 Inherits 메타 데이터에서입니다.Always use RegisterAttached to register properties where you specify Inherits in the metadata. 자세한 내용은 속성 값 상속을 참조하세요.For more information, see Property Value Inheritance.

적용 대상

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.

public:
 static System::Windows::DependencyPropertyKey ^ RegisterAttachedReadOnly(System::String ^ name, Type ^ propertyType, Type ^ ownerType, System::Windows::PropertyMetadata ^ defaultMetadata, System::Windows::ValidateValueCallback ^ validateValueCallback);
public static System.Windows.DependencyPropertyKey RegisterAttachedReadOnly (string name, Type propertyType, Type ownerType, System.Windows.PropertyMetadata defaultMetadata, System.Windows.ValidateValueCallback validateValueCallback);
static member RegisterAttachedReadOnly : string * Type * Type * System.Windows.PropertyMetadata * System.Windows.ValidateValueCallback -> System.Windows.DependencyPropertyKey
Public Shared Function RegisterAttachedReadOnly (name As String, propertyType As Type, ownerType As Type, defaultMetadata As PropertyMetadata, validateValueCallback As ValidateValueCallback) As DependencyPropertyKey

매개 변수

name
String

등록할 종속성 속성의 이름입니다.The name of the dependency property to register.

propertyType
Type

속성의 형식입니다.The type of the property.

ownerType
Type

종속성 속성을 등록하는 소유자 유형입니다.The owner type that is registering the dependency property.

defaultMetadata
PropertyMetadata

종속성 속성의 속성 메타데이터입니다.Property metadata for the dependency property.

validateValueCallback
ValidateValueCallback

일반적인 형식 유효성 검사 이외에 종속성 속성 값의 사용자 지정 유효성 검사를 수행하는 사용자가 만든 콜백에 대한 참조입니다.A reference to a user-created callback that should perform any custom validation of the dependency property value beyond typical type validation.

반환

DependencyPropertyKey

클래스의 정적 읽기 전용 필드 값을 설정하는 데 사용할 종속성 속성 키로, 나중에 종속성 속성을 참조하는 데 사용됩니다.A dependency property key that should be used to set the value of a static read-only field in your class, which is then used to reference the dependency property.

설명

이 메서드는 형식을 반환 DependencyPropertyKey반면 RegisterAttached 형식을 반환 DependencyProperty합니다.This method returns the type DependencyPropertyKey, whereas RegisterAttached returns the type DependencyProperty. 키 형식을 나타내는 일반적으로 DependencyProperty입니다.Typically, the keys that represent the type DependencyProperty. 일반적으로 읽기 전용 속성을 나타내는 키 되지 공용를 호출 하 여 종속성 속성 값을 설정 하는 키를 사용할 수 있으므로 SetValue(DependencyPropertyKey, Object)합니다.Typically, the keys that represent read-only properties are not made public, because the keys can be used to set the dependency property value by calling SetValue(DependencyPropertyKey, Object). 클래스 디자인 요구 사항에 영향이 있지만의 표시 유형 확인 하 고 액세스를 제한 하려면 일반적으로 좋습니다 DependencyPropertyKey 클래스 또는 애플리케이션 논리의 일부로 종속성 속성을 설정 하는 데 필요한 코드의 부분에 합니다.Your class design will affect your requirements, but it is generally recommended to limit the access and visibility of any DependencyPropertyKey to only those parts of your code that are necessary to set that dependency property as part of class or application logic. 값을 노출 하 여 읽기 전용 종속성 속성에 대 한 종속성 속성 식별자를 노출 하는 것이 좋습니다 DependencyPropertyKey.DependencyProperty 으로 public static readonly 클래스에 필드입니다.It is also recommended that you expose a dependency property identifier for the read-only dependency property, by exposing the value of DependencyPropertyKey.DependencyProperty as a public static readonly field on your class.

연결된 된 속성에 대 한 기본 시나리오에서 사용 하는 중 이므로 읽기 전용으로 연결 된 속성은 드문 경우 XAMLXAML합니다.Read-only attached properties are a rare scenario, because the primary scenario for an attached property is its use in XAMLXAML. Public setter를 하지 않고 연결된 된 속성에 설정할 수 없습니다 XAMLXAML 구문입니다.Without a public setter, an attached property cannot be set in XAMLXAML syntax.

종속성 속성 등록에 대 한 자세한 내용은 참조 하세요. DependencyProperty합니다.For more information on dependency property registration, see DependencyProperty.

종속성 속성 값 상속을 사용 하 여 RegisterAttachedUse RegisterAttached for Value-inheriting Dependency Properties

대신 연결 된 종속성 속성 등록에 대 한 한 가지 특정 시나리오 Register 속성 값 상속을 지원 하는 것입니다.One particular scenario for registering a dependency property as attached instead of Register is to support property value inheritance. 사용 하 여 종속성 속성 값 상속을 등록 해야 RegisterAttached 클래스는 종속성 속성을 노출 하는 속성 래퍼 접근자를 정의 하는 경우에 및 숨기지 않으려면 제공 하는 Get * 및 집합 * 정적 메서드를 노출 하려면 true를 연결 하는 경우에 접근자 지원 합니다.You should register value-inheriting dependency properties with RegisterAttached even if the class defines property wrapper accessors that expose the dependency property, and even if you do not intend to expose Get* and Set* static methods to provide true attached property support accessors. 속성 값 상속은 연결 되지 않은 종속성 속성에 대 한 작업에 표시 될 수 있지만 런타임 트리의 특정 요소 경계를 통해 연결 되지 않은 속성에 대 한 상속 동작은 정의 되지 않습니다.Although property value inheritance might appear to work for nonattached dependency properties, the inheritance behavior for a nonattached property through certain element boundaries in the runtime tree is undefined. 효과적으로 연결 속성을 등록 속성 시스템에 연결된 된 속성이 전역 속성으로 설정 및 속성 값 상속은 요소 트리에서 모든 경계에 걸쳐 작동 하는 보장 합니다.Registering the property as attached effectively makes the attached property a global property to the property system, and assures that property value inheritance works across all boundaries in an element tree. 항상 사용 하 여 RegisterAttached 지정 하는 속성을 등록 하려면 Inherits 메타 데이터에서입니다.Always use RegisterAttached to register properties where you specify Inherits in the metadata. 자세한 내용은 속성 값 상속을 참조하세요.For more information, see Property Value Inheritance.

적용 대상