Export (0) Print
Expand All

FrameworkPropertyMetadata.Merge Method

Enables a merge of the source metadata with base metadata.

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

protected override void Merge(
	PropertyMetadata baseMetadata,
	DependencyProperty dp
)

Parameters

baseMetadata
Type: System.Windows.PropertyMetadata

The base metadata to merge.

dp
Type: System.Windows.DependencyProperty

The dependency property this metadata is being applied to.

This method is used internally when metadata is being overridden.

Notes to Inheritors

Classes that derive from PropertyMetadata (or this class particularly) should override this method to account for any metadata properties they have added in their implementations. For instance, your implementation might have added a new flagwise enumeration value, and the Merge implementation should then be able to combine those flags correctly.

Always call the base implementation prior to your own implementation, because the base implementation takes care of merging all the properties already defined on previous types in the hierarchy.

The behavior added by the Merge implementation in FrameworkPropertyMetadata is that specific WPF framework-level properties in the metadata such as AffectsRender are combined in a bitwise or operation.

The Merge behavior also implements the behavior when you override the property metadata on an existing dependency property by calling OverrideMetadata., using override metadata that is FrameworkPropertyMetadata.

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

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

Show:
© 2014 Microsoft