This documentation is archived and is not being maintained.

DependencyProperty.GetMetadata Method (DependencyObject)

Returns the metadata for this dependency property as it exists on the specified object instance.

Namespace:  System.Windows
Assembly:  WindowsBase (in WindowsBase.dll)

public PropertyMetadata GetMetadata(
	DependencyObject dependencyObject


Type: System.Windows.DependencyObject
A dependency object that is checked for type, to determine which type-specific version of the dependency property the metadata should come from.

Return Value

Type: System.Windows.PropertyMetadata
A property metadata object.

Specifying either the type or an object reference is necessary because the metadata of any given dependency property can vary from the original registration due either to AddOwner or OverrideMetadata calls that can refine the property metadata as it exists on a type.

When you request property metadata based on an instance, you are really just passing the instance so that its type can be evaluated internally. Dependency property metadata does not vary per instance; it is always consistent for any given type-property combination.

The following example gets metadata for a dependency property based on a specific DependencyObject instance.

pm = MyAdvancedStateControl.StateProperty.GetMetadata(advancedInstance);

.NET Framework

Supported in: 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.