WPF MergedDictionaries详解

在 WPF 中，ResourceDictionary.MergedDictionaries 是一个非常重要的特性，用于将多个资源字典（ResourceDictionary）合并到一个主资源字典中。这种机制使得资源的管理和复用变得更加灵活和高效。

1. MergedDictionaries 的作用

MergedDictionaries 的主要作用是允许你将分散在不同文件中的资源集中管理，并将它们合并到一个统一的资源集合中。通过这种方式，你可以实现以下目标：

• 模块化设计：将不同的资源（如样式、模板、画刷等）分散到多个文件中，便于组织和维护。
• 资源共享：在多个控件或窗口之间共享资源，而无需重复定义。
• 动态切换资源：通过动态加载不同的资源字典，可以实现主题切换、语言切换等功能。

2. 语法结构

MergedDictionaries 是 ResourceDictionary 的一个属性，它是一个集合，可以包含多个子资源字典。每个子资源字典通过 Source 属性指定其来源。

<ResourceDictionary>
    <ResourceDictionary.MergedDictionaries>
        <!-- 合并其他资源字典 -->
        <ResourceDictionary Source="路径1" />
        <ResourceDictionary Source="路径2" />
    </ResourceDictionary.MergedDictionaries>

    <!-- 当前资源字典中的资源 -->
    <SolidColorBrush x:Key="PrimaryBrush" Color="Blue" />
</ResourceDictionary>

3. 工作原理

当 WPF 应用程序运行时，MergedDictionaries 中的资源会被合并到主资源字典中。这些资源可以通过 StaticResource 或 DynamicResource 进行引用。

资源查找顺序

WPF 在查找资源时会按照以下顺序进行：

1. 首先查找当前控件的资源（FrameworkElement.Resources 或 FrameworkContentElement.Resources）。
2. 如果未找到，则继续向上查找父级控件的资源。
3. 如果仍未找到，则查找应用程序级别的资源（Application.Resources）。
4. 最后查找 MergedDictionaries 中的资源。

因此，MergedDictionaries 中的资源优先级低于直接定义在当前资源字典中的资源。

4. 示例分析

以下是你的代码示例：

<ResourceDictionary>
    <ResourceDictionary.MergedDictionaries>
        <!-- 加载默认主题 -->
        <ResourceDictionary Source="pack://application:,,,/LayUI.Wpf;component/Themes/Default.xaml" />

        <!-- 定义语言资源 -->
        <ResourceDictionary x:Key="zh_CN" Source="pack://siteoforigin:,,,/Languaes/zh_CN.xaml" />
        <ResourceDictionary x:Key="en_US" Source="pack://siteoforigin:,,,/Languaes/en_US.xaml" />
    </ResourceDictionary.MergedDictionaries>
</ResourceDictionary>

4.1 加载默认主题

<ResourceDictionary Source="pack://application:,,,/LayUI.Wpf;component/Themes/Default.xaml" />

• 这段代码加载了一个名为 Default.xaml 的资源字典，该文件位于 LayUI.Wpf 程序集的 Themes 文件夹中。
• 通常用于定义控件的默认样式和模板（即主题）。
• 使用 pack://application:,,, URI 格式表示从程序集中加载资源。

4.2 定义语言资源

<ResourceDictionary x:Key="zh_CN" Source="pack://siteoforigin:,,,/Languaes/zh_CN.xaml" />
<ResourceDictionary x:Key="en_US" Source="pack://siteoforigin:,,,/Languaes/en_US.xaml" />

• 这两段代码分别加载了两个语言资源字典：zh_CN.xaml 和 en_US.xaml。
• 每个资源字典都有一个唯一的键（x:Key），以便后续可以通过键值动态切换语言。
• 使用 pack://siteoforigin:,,, URI 格式表示从应用程序的原始位置（通常是安装目录）加载资源。

5. 动态切换资源

通过 MergedDictionaries，你可以轻松实现动态切换资源的功能。例如，切换语言或主题。

示例：切换语言

假设你有一个 ResourceDictionary 用于存储语言资源，可以通过以下方式动态切换语言：

XAML 定义

<Window.Resources>
    <ResourceDictionary>
        <ResourceDictionary.MergedDictionaries>
            <ResourceDictionary x:Key="zh_CN" Source="pack://siteoforigin:,,,/Languages/zh_CN.xaml" />
            <ResourceDictionary x:Key="en_US" Source="pack://siteoforigin:,,,/Languages/en_US.xaml" />
        </ResourceDictionary.MergedDictionaries>
    </ResourceDictionary>
</Window.Resources>

C# 动态切换

// 获取当前窗口的资源字典
var mergedDictionaries = this.Resources.MergedDictionaries;

// 清除现有的语言资源
mergedDictionaries.Clear();

// 根据用户选择加载对应的语言资源
if (language == "zh_CN")
{
    mergedDictionaries.Add(new ResourceDictionary
    {
        Source = new Uri("pack://siteoforigin:,,,/Languages/zh_CN.xaml")
    });
}
else if (language == "en_US")
{
    mergedDictionaries.Add(new ResourceDictionary
    {
        Source = new Uri("pack://siteoforigin:,,,/Languages/en_US.xaml")
    });
}

6. 注意事项

6.1 资源覆盖

如果多个资源字典中定义了相同的键（x:Key），后面的资源字典会覆盖前面的资源。因此，加载顺序非常重要。

6.2 性能问题

虽然 MergedDictionaries 提供了灵活性，但过多的资源字典可能会导致性能下降。建议只加载必要的资源字典。

6.3 资源隔离

MergedDictionaries 中的资源是全局可用的，但如果需要隔离某些资源，可以考虑使用独立的资源字典而不合并。

7. 总结

• MergedDictionaries 的作用：将多个资源字典合并到一个主资源字典中，方便资源的模块化管理和复用。
• 典型应用场景：主题切换、语言切换、样式共享等。
• 资源查找顺序：当前资源 > 父级资源 > 应用程序资源 > 合并资源。
• 动态切换资源：通过动态加载和卸载资源字典，可以实现灵活的资源管理。

通过合理使用 MergedDictionaries，你可以构建更加模块化和可维护的 WPF 应用程序。