DependencyProperty.OverrideMetadata 메서드

정의

지정된 형식의 인스턴스에 있을 경우 이 종속성 속성에 대해 초기 종속성 속성 등록 시 제공된 메타데이터가 아니라 대체 메타데이터를 제공합니다.Supplies alternate metadata for this dependency property when it is present on instances of a specified type, versus the metadata that was provided in the initial dependency property registration.

오버로드

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.

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.

public:
 void OverrideMetadata(Type ^ forType, System::Windows::PropertyMetadata ^ typeMetadata);
public void OverrideMetadata (Type forType, System.Windows.PropertyMetadata typeMetadata);
member this.OverrideMetadata : Type * System.Windows.PropertyMetadata -> unit
Public Sub OverrideMetadata (forType As Type, typeMetadata As PropertyMetadata)

매개 변수

forType
Type

이 종속성 속성에 상속되는 형식이며, 지정된 대체 메타데이터에 적용될 형식입니다.The type where this dependency property is inherited and where the provided alternate metadata will be applied.

typeMetadata
PropertyMetadata

재정의하는 형식에서 종속성 속성에 적용할 메타데이터입니다.The metadata to apply to the dependency property on the overriding type.

예외

읽기 전용 종속성 속성에서 메타데이터 재정의를 시도한 경우(이 서명을 사용하여 해당 작업을 완료할 수 없음)An attempt was made to override metadata on a read-only dependency property (that operation cannot be done using this signature).

지정된 형식에 있는 종속성 속성에 대해 메타데이터가 이미 설정되어 있는 경우Metadata was already established for the dependency property as it exists on the provided type.

설명

속성 시스템 종속성 속성을 사용 하기 전에 종속성 속성 메타 데이터를 재정의 해야 합니다.Dependency property metadata should be overridden before the property system uses the dependency property. 이 종속성 속성을 등록 하는 클래스를 사용 하 여 특정 인스턴스가 생성 되는 경우와 같습니다.This equates to the time that specific instances are created using the class that registers the dependency property. 에 대 한 호출 OverrideMetadata 서 자신을 제공 하는 형식의 정적 생성자 내에 수행 해야 합니다 forType 이 메서드 또는 비슷한 인스턴스화를 통해 매개 변수입니다.Calls to OverrideMetadata should only be performed within the static constructors of the type that provides itself as the forType parameter of this method, or through similar instantiation. 소유자 형식의 인스턴스가 후 메타 데이터를 변경 하는 예외를 발생 하지 않지만 속성 시스템에서 일관성 없는 동작이 발생 합니다.Attempting to change metadata after instances of the owner type exist will not raise exceptions, but will result in inconsistent behaviors in the property system.

이 메서드를 사용 하 여 특정 파생된 클래스 재정의 대 한 메타 데이터 설정 되 면 이후에 동일한 파생된 클래스에서 메타 데이터 재정의 하려고 시도 하면 예외가 발생 합니다.After metadata for a particular derived class override is established with this method, subsequent attempts to override metadata on this same derived class will raise an exception.

제공 된 메타 데이터는 기본 소유자에 있는 종속성 속성의 속성 메타 데이터를 사용 하 여 병합 됩니다.The supplied metadata is merged with the property metadata for the dependency property as it exists on the base owner. 원래 기본 메타 데이터에 지정 된 특성 유지 됩니다. 새 메타 데이터에 특별히 변경 된 특성만 기본 메타 데이터의 특징을 재정의 합니다.Any characteristics that were specified in the original base metadata will persist; only those characteristics that were specifically changed in the new metadata will override the characteristics of the base metadata. 와 같은 몇 가지 특징 DefaultValue 새 메타 데이터에 지정 된 경우에 대체 됩니다.Some characteristics such as DefaultValue are replaced if specified in the new metadata. 다른 사용자와 같은 PropertyChangedCallback에 결합 됩니다.Others, such as PropertyChangedCallback, are combined. 병합 동작 하므로 여기에 설명 된 동작은 사용 되는 기존 속성 메타 데이터 클래스에 대 한 재정의 사용 중인 속성 메타 데이터 형식에 따라 다르며 WPFWPF 종속성 속성입니다.Ultimately, the merge behavior depends on the property metadata type being used for the override, so the behavior described here is for the existing property metadata classes used by WPFWPF dependency properties. 자세한 내용은 참조 하세요 종속성 속성 메타 데이터 하 고 프레임 워크 속성 메타 데이터입니다.For details, see Dependency Property Metadata and Framework Property Metadata.

적용 대상

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.

public:
 void OverrideMetadata(Type ^ forType, System::Windows::PropertyMetadata ^ typeMetadata, System::Windows::DependencyPropertyKey ^ key);
public void OverrideMetadata (Type forType, System.Windows.PropertyMetadata typeMetadata, System.Windows.DependencyPropertyKey key);
member this.OverrideMetadata : Type * System.Windows.PropertyMetadata * System.Windows.DependencyPropertyKey -> unit
Public Sub OverrideMetadata (forType As Type, typeMetadata As PropertyMetadata, key As DependencyPropertyKey)

매개 변수

forType
Type

이 종속성 속성에 상속되는 형식이며, 지정된 대체 메타데이터에 적용될 형식입니다.The type where this dependency property is inherited and where the provided alternate metadata will be applied.

typeMetadata
PropertyMetadata

재정의하는 형식에서 종속성 속성에 적용할 메타데이터입니다.The metadata to apply to the dependency property on the overriding type.

key
DependencyPropertyKey

읽기 전용 종속성 속성에 대한 액세스 키입니다.The access key for a read-only dependency property.

설명

이 서명은 읽기 전용 종속성 속성 식별자에 대 한 기본 구현 (DependencyPropertyKey) 메서드.This signature provides underlying implementation for a read-only dependency property identifier (DependencyPropertyKey) method. 읽기-쓰기 종속성 속성에 대 한 메타 데이터를 재정의 하는 경우 사용 하 여 OverrideMetadata(Type, PropertyMetadata)입니다.If overriding metadata for a read-write dependency property, use OverrideMetadata(Type, PropertyMetadata).

속성 시스템 종속성 속성을 사용 하기 전에 종속성 속성 메타 데이터를 재정의 해야 합니다.Dependency property metadata should be overridden before the property system uses the dependency property. 이 종속성 속성을 등록 하는 클래스에 대 한 시간을 특정 개체가 만들어지는 것과 같습니다.This equates to the time that specific objects are created for the class that registers the dependency property. 에 대 한 호출 OverrideMetadata 서 자신을 제공 하는 형식의 정적 생성자 내에 수행 해야 합니다 forType 이 메서드 또는 비슷한 인스턴스화를 통해 매개 변수입니다.Calls to OverrideMetadata should only be performed within the static constructors of the type that provides itself as the forType parameter of this method, or through similar instantiation. 소유자 형식의 인스턴스가 후 메타 데이터를 변경 하는 예외를 발생 하지 않지만 속성 시스템에서 일관성 없는 동작이 발생 합니다.Attempting to change metadata after instances of the owner type exist will not raise exceptions, but will result in inconsistent behaviors in the property system.

이 메서드를 사용 하 여 특정 파생된 클래스 재정의 대 한 메타 데이터 설정 되 면 이후에 동일한 파생된 클래스에서 메타 데이터 재정의 하려고 시도 하면 예외가 발생 합니다.After metadata for a particular derived class override is established with this method, subsequent attempts to override metadata on this same derived class will raise an exception.

제공 된 메타 데이터는 기본 소유자에 있는 종속성 속성의 속성 메타 데이터를 사용 하 여 병합 됩니다.The supplied metadata is merged with the property metadata for the dependency property as it exists on the base owner. 원래 기본 메타 데이터에 지정 된 특성 유지 됩니다. 새 메타 데이터에 특별히 변경 된 특성만 기본 메타 데이터의 특징을 재정의 합니다.Any characteristics that were specified in the original base metadata will persist; only those characteristics that were specifically changed in the new metadata will override the characteristics of the base metadata. 와 같은 몇 가지 특징 DefaultValue 새 메타 데이터에 지정 된 경우에 대체 됩니다.Some characteristics such as DefaultValue are replaced if specified in the new metadata. 다른 사용자와 같은 PropertyChangedCallback에 결합 됩니다.Others, such as PropertyChangedCallback, are combined. 병합 동작을 재정의 하는 데 사용 되 고 속성 메타 데이터 형식에 따라 달라 집니다.The merge behavior depends on the property metadata type being used for the override. 자세한 내용은 참조 하세요 종속성 속성 메타 데이터 하 고 프레임 워크 속성 메타 데이터입니다.For details, see Dependency Property Metadata and Framework Property Metadata.

적용 대상