MergedDictionaries Property

ResourceDictionary::MergedDictionaries Property

 

Gets a collection of the ResourceDictionary dictionaries that constitute the various resource dictionaries in the merged dictionaries.

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

public:
property Collection<ResourceDictionary^>^ MergedDictionaries {
	Collection<ResourceDictionary^>^ get();
}

Property Value

Type: System.Collections.ObjectModel::Collection<ResourceDictionary^>^

The collection of merged dictionaries.

Dictionaries are merged by adding a ResourceDictionary to the generic collection referenced by MergedDictionaries. A merged ResourceDictionary does not have resource elements defined within it in markup. Instead, the merged dictionary is a ResourceDictionary with no markup child elements defined (or with no elements added through code), but with a URI specified for Source. The Source designation enables the merged dictionary to come from an external source, such as a separate resource assembly that ships with the application, "loose XAML", or a specific localization or global resources assembly.

Specifying resource elements within a ResourceDictionary that has Source specified is not supported.

Lookup behavior within the MergedDictionaries collection will search the last-added ResourceDictionary first, and the search stops as soon as a requested key is found. Duplicate keys across the collection of merged dictionaries are not illegal. For more information on merged dictionary behavior, see Merged Resource Dictionaries.

<object>
  <object.MergedDictionaries>
    oneOrMoreResourceDictionaries
  </object.MergedDictionaries>
</object>

oneOrMoreResourceDictionaries

One or more ResourceDictionary object elements. A ResourceDictionary used for MergedDictionaries does not have collection content, and specifies a Source attribute that references the complete ResourceDictionary remotely.

The following example specifies two ResourceDictionary elements to be merged into the primary ResourceDictionary.

<Page.Resources>
  <ResourceDictionary>
    <ResourceDictionary.MergedDictionaries>
      <ResourceDictionary Source="myresourcedictionary.xaml"/>
      <ResourceDictionary Source="myresourcedictionary2.xaml"/>
    </ResourceDictionary.MergedDictionaries>
  </ResourceDictionary>
</Page.Resources>

.NET Framework
Available since 3.0
Silverlight
Available since 3.0
Windows Phone Silverlight
Available since 7.0
Return to top
Show:
© 2016 Microsoft