DependencyProperty.GetMetadata 方法

定义

返回与此依赖属性关联的的元数据(只要它对于特定的类型存在)。 它可以是在其中首次注册依赖属性的类型、随后将其添加到的类型,或在其中通过继承获取依赖属性而已专门重写元数据的类型。

重载

GetMetadata(Type)

返回此依赖属性的元数据,因为它存在于指定的现有类型上。

GetMetadata(DependencyObject)

返回此依赖属性的元数据,因为它存在于指定的对象实例上。

GetMetadata(DependencyObjectType)

为此依赖属性(当它位于指定的对象实例上时)返回元数据。

GetMetadata(Type)

返回此依赖属性的元数据,因为它存在于指定的现有类型上。

public:
 System::Windows::PropertyMetadata ^ GetMetadata(Type ^ forType);
public System.Windows.PropertyMetadata GetMetadata (Type forType);
member this.GetMetadata : Type -> System.Windows.PropertyMetadata
Public Function GetMetadata (forType As Type) As PropertyMetadata

参数

forType
Type

要从中检索依赖属性元数据的特定类型。

返回

PropertyMetadata

属性元数据对象。

示例

以下示例根据依赖项属性的类型获取依赖项属性的元数据。 该类型是使用 typeof 运算符获取的。

pm = MyStateControl.StateProperty.GetMetadata(typeof(MyStateControl));
pm = MyStateControl.StateProperty.GetMetadata(GetType(MyStateControl))

注解

需要指定用作类型的类型或对象引用,因为元数据可能因更改类型上的依赖属性元数据的调用而因原始注册AddOwnerOverrideMetadata而异。

适用于

GetMetadata(DependencyObject)

返回此依赖属性的元数据,因为它存在于指定的对象实例上。

public:
 System::Windows::PropertyMetadata ^ GetMetadata(System::Windows::DependencyObject ^ dependencyObject);
public System.Windows.PropertyMetadata GetMetadata (System.Windows.DependencyObject dependencyObject);
member this.GetMetadata : System.Windows.DependencyObject -> System.Windows.PropertyMetadata
Public Function GetMetadata (dependencyObject As DependencyObject) As PropertyMetadata

参数

dependencyObject
DependencyObject

一个依赖对象,检查了其类型,以便确定元数据应来自依赖属性的哪个类型特定版本。

返回

PropertyMetadata

属性元数据对象。

示例

以下示例基于特定 DependencyObject 实例获取依赖属性的元数据。

pm = MyAdvancedStateControl.StateProperty.GetMetadata(advancedInstance);
pm = MyAdvancedStateControl.StateProperty.GetMetadata(advancedInstance)

注解

必须指定类型或对象引用,因为任何给定依赖属性的元数据可能因原始注册而异 AddOwner ,或者 OverrideMetadata 调用可以优化类型上存在的属性元数据。

根据实例请求属性元数据时,实际上只需传递实例,以便可以在内部评估其类型。 依赖属性元数据不会因实例而异;对于任何给定的类型属性组合,它始终一致。

适用于

GetMetadata(DependencyObjectType)

为此依赖属性(当它位于指定的对象实例上时)返回元数据。

public:
 System::Windows::PropertyMetadata ^ GetMetadata(System::Windows::DependencyObjectType ^ dependencyObjectType);
public System.Windows.PropertyMetadata GetMetadata (System.Windows.DependencyObjectType dependencyObjectType);
member this.GetMetadata : System.Windows.DependencyObjectType -> System.Windows.PropertyMetadata
Public Function GetMetadata (dependencyObjectType As DependencyObjectType) As PropertyMetadata

参数

dependencyObjectType
DependencyObjectType

一个特定对象,该对象记录需要其中的依赖属性元数据的依赖项对象类型。

返回

PropertyMetadata

属性元数据对象。

示例

以下示例基于其 DependencyObjectType获取依赖属性的元数据。

DependencyObjectType dt = unrelatedInstance.DependencyObjectType;
pm = UnrelatedStateControl.StateProperty.GetMetadata(dt);
Dim dt As DependencyObjectType = unrelatedInstance.DependencyObjectType
pm = UnrelatedStateControl.StateProperty.GetMetadata(dt)

注解

必须指定类型或对象引用,因为任何给定依赖属性的元数据可能因原始注册而异 AddOwner ,或者 OverrideMetadata 调用可以优化类型上存在的属性元数据。

适用于