DependencyProperty.GetMetadata 方法

定义

命名空间:

System.Windows

程序集:

WindowsBase.dll

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

重载

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 调用这些元数据可以优化类型上存在的属性元数据。