ResourceDictionary.MergedDictionaries Property

Reference

Definition

Namespace:: System.Windows

Assembly:: PresentationFramework.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

public:
 property System::Collections::ObjectModel::Collection<System::Windows::ResourceDictionary ^> ^ MergedDictionaries { System::Collections::ObjectModel::Collection<System::Windows::ResourceDictionary ^> ^ get(); };

public System.Collections.ObjectModel.Collection<System.Windows.ResourceDictionary> MergedDictionaries { get; }

member this.MergedDictionaries : System.Collections.ObjectModel.Collection<System.Windows.ResourceDictionary>

Public ReadOnly Property MergedDictionaries As Collection(Of ResourceDictionary)

Property Value

Collection<ResourceDictionary>

The collection of merged dictionaries.

Examples

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

XAML

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

Remarks

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.

XAML Property Element Usage

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

XAML Values

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.

Applies to

Product	Versions
.NET Framework	3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

Share via