WPF MergedDictionaries详解

news2025/3/26 6:14:40

在 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 在查找资源时会按照以下顺序进行：

首先查找当前控件的资源（FrameworkElement.Resources 或 FrameworkContentElement.Resources）。
如果未找到，则继续向上查找父级控件的资源。
如果仍未找到，则查找应用程序级别的资源（Application.Resources）。
最后查找 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")
    });
}