ResourceDictionary.MergedDictionaries Property

Definition

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

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.

<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.

See also

• Source