C# WPF 资源字典详解：ResourceDictionary、MergedDictionaries 与自定义控件案例

C# WPF 资源字典详解：ResourceDictionary、MergedDictionaries 与自定义控件案例

导语：项目里有几十个窗口、上百个按钮，样式如果每个窗口都写一遍，改起来就是灾难。WPF 的 ResourceDictionary（资源字典）就是一个"公共样式仓库"：把通用的样式、画笔单独放进独立文件，所有窗口都能引用，改一处全局生效。本文基于我自己的资源字典学习程序，先讲怎么写、怎么引入，再用一个自定义圆角按钮做综合案例，大白话配合可运行代码，适合已经会写 Style、想做统一主题管理的同学。

一、什么是 ResourceDictionary

ResourceDictionary（资源字典）是一个独立的 XAML 文件，用来集中存放项目里通用的资源，比如样式、画笔、模板，需要的地方通过 x:Key 引用。

打个比方：资源字典就像一个"公共仓库"，样式是一件件打包好的工具，谁要用就来仓库领，不用每家每户自己造；仓库里的工具改了，所有领过的人拿到的都是最新版。

二、先写一个资源字典文件

新建一个独立的 ButtonDic.xaml，里面放一个按钮样式：

<!-- ResourceDictionary 是根节点，里面放通用资源 -->
<ResourceDictionary
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">

    <!-- 一个带 x:Key 的样式，引用时靠这个 key 找到 -->
    <Style x:Key="ButtonGlobal" TargetType="Button">
        <Setter Property="Width" Value="150"/>
        <Setter Property="Height" Value="50"/>
        <Setter Property="Foreground" Value="Red"/>
        <Setter Property="BorderThickness" Value="0"/>
        <Setter Property="Background" Value="#43a9c7"/>
    </Style>
</ResourceDictionary>

三、窗口级引入：单个字典

在某个窗口的 Window.Resources 里，用 Source 引入字典文件：

<Window.Resources>
    <!-- 引入单个资源字典，Source 指向文件路径 -->
    <ResourceDictionary x:Name="ButtonResource" Source="/Resources/ButtonDic.xaml"/>
</Window.Resources>

<StackPanel>
    <!-- 用 StaticResource 引用字典里的样式 -->
    <Button Content="测试资源字典引入" Style="{StaticResource ButtonGlobal}"/>
</StackPanel>

这种方式只在当前窗口生效，适合某个页面专用的资源。

四、应用级引入：MergedDictionaries 合并

想让所有窗口都能用，就在 App.xaml 里用 MergedDictionaries（合并字典） 把多个字典一次性合并进应用资源：

<Application.Resources>
    <ResourceDictionary>
        <ResourceDictionary.MergedDictionaries>
            <!-- 合并多个字典，每个用 Source 指向一个文件 -->
            <ResourceDictionary Source="/Resources/Dic1.xaml"/>
            <ResourceDictionary Source="/Resources/Dic2.xaml"/>
        </ResourceDictionary.MergedDictionaries>
    </ResourceDictionary>
</Application.Resources>

窗口里引用全局合并的样式，用 DynamicResource：

<Button Content="测试全局合并" Style="{DynamicResource ButtonDefault1}"/>

五、两种路径写法

Source 指向字典文件时有两种写法：

路径写法	示例	说明
相对路径	/Resources/Dic1.xaml	以项目为根，写法简单，最常用
Pack URI	pack://application:,,,/Resources/TextBlockDic.xaml	完整绝对路径，跨程序集引用时用

Pack URI 里 application:,,, 表示当前程序集，后面跟文件路径，引用其他类库中的资源时必须用这种完整写法。

六、StaticResource 与 DynamicResource 再强调

资源字典里到底用哪种引用，记住这个规律：

• 窗口级单独引入的字典，用 StaticResource：加载时确定。
• App 全局合并的字典，用 DynamicResource：运行时查找，资源变化能更新。

七、综合案例：自定义圆角按钮

下面把资源字典、控件模板、自定义控件串起来，做一个带圆角的自定义按钮。

7.1 写自定义控件：依赖属性

先定义一个继承 Button 的 ConnerButton，用 DependencyProperty（依赖属性） 注册一个 CornerRadius 属性，让它能像普通属性一样在 XAML 里设置：

using System.Windows;
using System.Windows.Controls;
using System.Windows.Media;

namespace MyApp.UIControls
{
    public class ConnerButton : Button
    {
        // 注册依赖属性：属性名 CornerRadius、类型 CornerRadius、属于 ConnerButton
        public static readonly DependencyProperty CornerRadiusProperty =
            DependencyProperty.Register("CornerRadius",
                                        typeof(CornerRadius),
                                        typeof(ConnerButton));

        // 普通属性包装，内部用 GetValue/SetValue 读写依赖属性
        public CornerRadius CornerRadius
        {
            get { return (CornerRadius)GetValue(CornerRadiusProperty); }
            set { SetValue(CornerRadiusProperty, value); }
        }

        // 同样方式再注册一个鼠标进入背景画刷
        public static readonly DependencyProperty MouseEnterBackgroundProperty =
            DependencyProperty.Register("MouseEnterBackground",
                                        typeof(Brush),
                                        typeof(ConnerButton));

        public Brush MouseEnterBackground
        {
            get { return (Brush)GetValue(MouseEnterBackgroundProperty); }
            set { SetValue(MouseEnterBackgroundProperty, value); }
        }
    }
}

7.2 在资源字典里写样式和模板

在 ButtonDic.xaml 里给 ConnerButton 写样式，模板里用 TemplateBinding 把圆角接进来：

<ResourceDictionary
    xmlns:control="clr-namespace:MyApp.UIControls" ...>

    <!-- 准备几个状态画刷 -->
    <SolidColorBrush x:Key="Button.Static.Background" Color="Purple"/>
    <SolidColorBrush x:Key="Button.MouseOver.Background" Color="Turquoise"/>

    <Style x:Key="ButtonStyle1" TargetType="{x:Type control:ConnerButton}">
        <Setter Property="Background" Value="{StaticResource Button.Static.Background}"/>
        <Setter Property="Width" Value="150"/>
        <Setter Property="Height" Value="50"/>
        <Setter Property="Content" Value="登录"/>

        <Setter Property="Template">
            <Setter.Value>
                <ControlTemplate TargetType="{x:Type control:ConnerButton}">
                    <!-- 圆角通过 TemplateBinding 绑定控件的 CornerRadius -->
                    <Border x:Name="border"
                        Background="{TemplateBinding Background}"
                        CornerRadius="{TemplateBinding CornerRadius}">
                        <ContentPresenter HorizontalAlignment="Center"
                                          VerticalAlignment="Center"/>
                    </Border>
                    <ControlTemplate.Triggers>
                        <Trigger Property="IsMouseOver" Value="True">
                            <Setter Property="Background" TargetName="border" Value="Green"/>
                        </Trigger>
                    </ControlTemplate.Triggers>
                </ControlTemplate>
            </Setter.Value>
        </Setter>
    </Style>
</ResourceDictionary>

7.3 全局合并并使用

App.xaml 合并这个字典：

<ResourceDictionary.MergedDictionaries>
    <ResourceDictionary Source="/Resources/ButtonDic.xaml"/>
</ResourceDictionary.MergedDictionaries>

窗口里先导入自定义控件命名空间，再使用：

<Window xmlns:control="clr-namespace:MyApp.UIControls" ...>
    <Grid>
        <!-- 自定义控件必须先注册命名空间；圆角直接在属性里设置 -->
        <control:ConnerButton CornerRadius="20"
                              Foreground="Red"
                              Style="{StaticResource ButtonStyle1}"/>
    </Grid>
</Window>

【插图 1：WPF 资源字典的合并与引用关系】

八、常见坑

1. 报找不到资源。 先确认字典文件路径和 Source 一致，x:Key 拼写正确；资源字典没被引入，里面的样式再正确也找不到。

2. 全局合并的样式用 StaticResource 不生效。 App 里 MergedDictionaries 合并的资源，引用时用 DynamicResource；窗口级单独引入的才用 StaticResource。

3. 多个字典里用了相同的 key，样式冲突。 合并字典时同 key 会互相覆盖，注意保持 key 唯一，或明确知道哪个在后、以哪个为准。

4. 自定义控件在 XAML 里报错。 使用自定义控件必须先在窗口顶部用 xmlns 注册命名空间，否则 XAML 不认识这个类型。

5. 依赖属性当普通属性写，绑定不生效。 WPF 的属性系统要求用 DependencyProperty.Register 注册，再用 GetValue/SetValue 包装，直接写普通属性无法支持绑定和模板。

九、小结

1. ResourceDictionary 是集中存放通用资源的独立文件，改一处全局生效。
2. 引入分两级：窗口级用 Window.Resources + StaticResource，应用级用 App 的 MergedDictionaries + DynamicResource。
3. 路径有相对路径和 Pack URI 两种，跨程序集用完整 Pack URI。
4. 综合案例里，自定义控件用 DependencyProperty 注册属性，资源字典配合 ControlTemplate 实现圆角按钮。

---