WPF之静态资源与动态资源

可以根据Github拉取示例程序运行
GitHub程序演示地址（点击直达）
也可以在本文资源中下载

引言

在WPF应用开发中，资源系统是一个强大的特性，允许开发者定义、管理和重用各种应用资源。WPF提供了两种主要的资源引用方式：静态资源（StaticResource）和动态资源（DynamicResource）。这两种资源类型有着不同的行为特征、性能特点和使用场景。本文将深入剖析这两种资源类型的工作原理、差异以及各自的最佳应用场景。

资源系统基础

在深入了解静态资源和动态资源之前，我们需要先了解WPF资源系统的基本概念。

什么是资源？

在WPF中，资源是可以在XAML中定义并在应用程序中重复使用的对象。这些资源可以是样式、模板、画刷、颜色、字体等几乎任何类型的对象。

资源字典

资源通常存储在资源字典（ResourceDictionary）中，可以在不同级别定义：

资源查找机制

WPF使用逻辑树向上查找资源的机制：

静态资源 (StaticResource)

概念与语法

StaticResource是一种在应用加载时解析一次的资源引用方式。它在XAML解析阶段进行评估，之后不再重新解析。

基本语法：

<Button Background="{StaticResource MyBrush}" Content="静态资源按钮"/>

工作原理

静态资源的核心特点是"一次性解析"：

示例代码

<Window x:Class="StaticResourceDemo.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="静态资源示例" Height="350" Width="500">
    
    <!-- 定义窗口级资源 -->
    <Window.Resources>
        <!-- 定义一个SolidColorBrush资源 -->
        <SolidColorBrush x:Key="PrimaryBrush" Color="Blue"/>
        
        <!-- 定义一个样式资源 -->
        <Style x:Key="ButtonStyle" TargetType="Button">
            <Setter Property="Background" Value="{StaticResource PrimaryBrush}"/>
            <Setter Property="Foreground" Value="White"/>
            <Setter Property="Padding" Value="10,5"/>
            <Setter Property="Margin" Value="5"/>
        </Style>
    </Window.Resources>
    
    <StackPanel Margin="20">
        <TextBlock Text="静态资源示例" FontSize="20" Margin="0,0,0,20"/>
        
        <!-- 使用静态资源引用样式 -->
        <Button Content="使用静态资源样式的按钮" 
                Style="{StaticResource ButtonStyle}"/>
        
        <!-- 直接使用静态资源引用画刷 -->
        <TextBlock Text="使用静态资源画刷的文本" 
                   Foreground="{StaticResource PrimaryBrush}"
                   FontSize="16" Margin="0,20,0,0"/>
    </StackPanel>
</Window>

特点总结

1. 加载时解析：在XAML加载时进行一次性解析
2. 性能优势：由于只解析一次，性能开销较小
3. 资源不可变：一旦解析，即使原始资源发生变化，使用该资源的控件也不会更新
4. 查找失败异常：如果找不到资源，会抛出异常

动态资源 (DynamicResource)

概念与语法

DynamicResource提供了一种可以在运行时动态更新的资源引用方式。它建立了一个到资源字典键的引用，而不是到资源值的引用。

基本语法：

<Button Background="{DynamicResource MyBrush}" Content="动态资源按钮"/>

工作原理

动态资源的核心特点是"建立资源键引用"：

示例代码

<Window x:Class="DynamicResourceDemo.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="动态资源示例" Height="400" Width="600">
    
    <Window.Resources>
        <!-- 定义初始资源 -->
        <SolidColorBrush x:Key="DynamicBrush" Color="Red"/>
        
        <Style x:Key="DynamicButtonStyle" TargetType="Button">
            <Setter Property="Background" Value="{DynamicResource DynamicBrush}"/>
            <Setter Property="Foreground" Value="White"/>
            <Setter Property="Padding" Value="10,5"/>
            <Setter Property="Margin" Value="5"/>
        </Style>
    </Window.Resources>
    
    <Grid>
        <Grid.RowDefinitions>
            <RowDefinition Height="Auto"/>
            <RowDefinition Height="*"/>
            <RowDefinition Height="Auto"/>
        </Grid.RowDefinitions>
        
        <TextBlock Text="动态资源示例" FontSize="20" Margin="20,20,20,10"/>
        
        <StackPanel Grid.Row="1" Margin="20">
            <!-- 使用动态资源引用样式 -->
            <Button Content="使用动态资源样式的按钮" 
                    Style="{DynamicResource DynamicButtonStyle}"
                    Height="40"/>
            
            <!-- 直接使用动态资源引用画刷 -->
            <TextBlock Text="使用动态资源画刷的文本" 
                       Foreground="{DynamicResource DynamicBrush}"
                       FontSize="16" Margin="0,20,0,0"
                       Height="30"/>
            
            <!-- 静态资源对比 -->
            <Button Content="使用静态资源样式的按钮(不会变化)" 
                    Background="{StaticResource DynamicBrush}"
                    Foreground="White"
                    Margin="5" Padding="10,5"
                    Height="40"/>
        </StackPanel>
        
        <!-- 按钮控制资源变化 -->
        <StackPanel Grid.Row="2" Orientation="Horizontal" Margin="20" HorizontalAlignment="Center">
            <Button Content="变为绿色" Padding="10,5" Margin="5" Click="ChangeToGreen_Click"/>
            <Button Content="变为蓝色" Padding="10,5" Margin="5" Click="ChangeToBlue_Click"/>
            <Button Content="变为原始红色" Padding="10,5" Margin="5" Click="ChangeToRed_Click"/>
        </StackPanel>
    </Grid>
</Window>

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

namespace DynamicResourceDemo
{
    public partial class MainWindow : Window
    {
        public MainWindow()
        {
            InitializeComponent();
        }

        // 点击事件处理程序：将动态资源更改为绿色
        private void ChangeToGreen_Click(object sender, RoutedEventArgs e)
        {
            // 查找并更新资源字典中的资源
            this.Resources["DynamicBrush"] = new SolidColorBrush(Colors.Green);
        }

        // 点击事件处理程序：将动态资源更改为蓝色
        private void ChangeToBlue_Click(object sender, RoutedEventArgs e)
        {
            this.Resources["DynamicBrush"] = new SolidColorBrush(Colors.Blue);
        }

        // 点击事件处理程序：将动态资源恢复为原始红色
        private void ChangeToRed_Click(object sender, RoutedEventArgs e)
        {
            this.Resources["DynamicBrush"] = new SolidColorBrush(Colors.Red);
        }
    }
}

特点总结

1. 引用键而非值：引用的是资源字典中的键，而不是实际值
2. 运行时解析：在需要资源时进行解析，而非加载时
3. 动态响应变化：当资源字典中的资源发生变化时，使用该资源的控件会自动更新
4. 性能开销：由于需要维护资源引用和监听变化，性能开销较大
5. 查找失败宽容：如果找不到资源，不会立即抛出异常，而是显示为默认值

静态资源与动态资源的比较

性能差异

两种资源引用方式在性能上有明显区别：

使用场景比较

特点	静态资源	动态资源
解析时机	XAML加载解析时	运行时按需解析
引用方式	直接引用资源值	引用资源键
资源更新	不响应资源变化	自动响应资源变化
性能开销	低	较高
内存占用	低	较高
最适用场景	固定不变的资源	需要动态更新的资源

代码示例：两者结合使用

<Window x:Class="ResourceComparisonDemo.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="资源比较示例" Height="450" Width="600">
    
    <Window.Resources>
        <!-- 颜色资源 -->
        <Color x:Key="PrimaryColor">#FF1A73E8</Color>
        <Color x:Key="SecondaryColor">#FF34A853</Color>
        
        <!-- 基于颜色创建的画刷 -->
        <SolidColorBrush x:Key="PrimaryBrush" Color="{StaticResource PrimaryColor}"/>
        <SolidColorBrush x:Key="SecondaryBrush" Color="{StaticResource SecondaryColor}"/>
        <SolidColorBrush x:Key="ThemeBrush" Color="{StaticResource PrimaryColor}"/>
        
        <!-- 样式资源 -->
        <Style x:Key="StaticButtonStyle" TargetType="Button">
            <!-- 静态引用画刷资源 -->
            <Setter Property="Background" Value="{StaticResource PrimaryBrush}"/>
            <Setter Property="Foreground" Value="White"/>
            <Setter Property="Padding" Value="15,8"/>
            <Setter Property="Margin" Value="5"/>
        </Style>
        
        <Style x:Key="DynamicButtonStyle" TargetType="Button">
            <!-- 动态引用画刷资源 -->
            <Setter Property="Background" Value="{DynamicResource ThemeBrush}"/>
            <Setter Property="Foreground" Value="White"/>
            <Setter Property="Padding" Value="15,8"/>
            <Setter Property="Margin" Value="5"/>
        </Style>
    </Window.Resources>
    
    <Grid Margin="20">
        <Grid.RowDefinitions>
            <RowDefinition Height="Auto"/>
            <RowDefinition Height="*"/>
            <RowDefinition Height="Auto"/>
        </Grid.RowDefinitions>
        
        <TextBlock Text="静态资源与动态资源比较" FontSize="22" Margin="0,0,0,20"/>
        
        <Grid Grid.Row="1">
            <Grid.ColumnDefinitions>
                <ColumnDefinition Width="*"/>
                <ColumnDefinition Width="*"/>
            </Grid.ColumnDefinitions>
            
            <!-- 静态资源专区 -->
            <StackPanel Grid.Column="0" Margin="0,0,10,0">
                <TextBlock Text="静态资源区域" FontSize="16" FontWeight="Bold" Margin="0,0,0,10"/>
                <Button Content="静态样式按钮" Style="{StaticResource StaticButtonStyle}"/>
                <TextBlock Text="静态引用的文本颜色" Foreground="{StaticResource PrimaryBrush}" 
                           Margin="5,20,5,5" FontSize="14"/>
                <Rectangle Height="40" Fill="{StaticResource PrimaryBrush}" Margin="5"/>
                <TextBlock Text="静态资源在应用程序加载时解析一次，不会响应资源变化，性能开销小。" 
                           TextWrapping="Wrap" Margin="5,10,5,5"/>
            </StackPanel>
            
            <!-- 动态资源专区 -->
            <StackPanel Grid.Column="1" Margin="10,0,0,0">
                <TextBlock Text="动态资源区域" FontSize="16" FontWeight="Bold" Margin="0,0,0,10"/>
                <Button Content="动态样式按钮" Style="{DynamicResource DynamicButtonStyle}"/>
                <TextBlock Text="动态引用的文本颜色" Foreground="{DynamicResource ThemeBrush}" 
                           Margin="5,20,5,5" FontSize="14"/>
                <Rectangle Height="40" Fill="{DynamicResource ThemeBrush}" Margin="5"/>
                <TextBlock Text="动态资源在运行时解析，会响应资源字典中的资源变化，性能开销较大。" 
                           TextWrapping="Wrap" Margin="5,10,5,5"/>
            </StackPanel>
        </Grid>
        
        <!-- 控制按钮区域 -->
        <StackPanel Grid.Row="2" Orientation="Horizontal" HorizontalAlignment="Center" Margin="0,20,0,0">
            <Button Content="更换主题色为蓝色" Padding="10,5" Margin="5" Click="ChangeThemeToBlue_Click"/>
            <Button Content="更换主题色为绿色" Padding="10,5" Margin="5" Click="ChangeThemeToGreen_Click"/>
            <Button Content="更换主题色为红色" Padding="10,5" Margin="5" Click="ChangeThemeToRed_Click"/>
        </StackPanel>
    </Grid>
</Window>

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

namespace ResourceComparisonDemo
{
    public partial class MainWindow : Window
    {
        public MainWindow()
        {
            InitializeComponent();
        }

        // 将主题色更改为蓝色
        private void ChangeThemeToBlue_Click(object sender, RoutedEventArgs e)
        {
            // 注意：这里更新的是ThemeBrush资源
            // 使用StaticResource引用此资源的控件不会更新
            // 使用DynamicResource引用此资源的控件会自动更新
            this.Resources["ThemeBrush"] = new SolidColorBrush(Color.FromRgb(26, 115, 232)); // 蓝色
        }

        // 将主题色更改为绿色
        private void ChangeThemeToGreen_Click(object sender, RoutedEventArgs e)
        {
            this.Resources["ThemeBrush"] = new SolidColorBrush(Color.FromRgb(52, 168, 83)); // 绿色
        }

        // 将主题色更改为红色
        private void ChangeThemeToRed_Click(object sender, RoutedEventArgs e)
        {
            this.Resources["ThemeBrush"] = new SolidColorBrush(Color.FromRgb(234, 67, 53)); // 红色
        }
    }
}

资源替换行为详解

静态资源的替换行为

静态资源在以下情况下无法响应变化：

1. 资源字典中的资源被替换
2. 资源字典被合并字典(MergedDictionaries)替换
3. App.xaml中的资源被修改

动态资源的替换行为

动态资源可以响应以下几种情况：

1. 资源字典中的资源被替换
2. 资源字典被合并字典替换
3. 系统主题变化（如从浅色主题切换到深色主题）

实现资源替换的代码示例

// 在代码中动态替换资源
public void SwitchTheme(string themeName)
{
    // 清除当前资源字典中的合并字典
    Application.Current.Resources.MergedDictionaries.Clear();
    
    // 创建并加载新的资源字典
    ResourceDictionary newDict = new ResourceDictionary();
    
    // 根据主题名称加载不同的资源字典
    switch (themeName)
    {
        case "Dark":
            newDict.Source = new Uri("/Themes/DarkTheme.xaml", UriKind.Relative);
            break;
        case "Light":
            newDict.Source = new Uri("/Themes/LightTheme.xaml", UriKind.Relative);
            break;
        case "Blue":
            newDict.Source = new Uri("/Themes/BlueTheme.xaml", UriKind.Relative);
            break;
        default:
            newDict.Source = new Uri("/Themes/DefaultTheme.xaml", UriKind.Relative);
            break;
    }
    
    // 将新的资源字典添加到应用程序资源
    Application.Current.Resources.MergedDictionaries.Add(newDict);
}

资源引用深入探讨

前置资源引用

在XAML中，可以引用后面定义的资源，但要使用DynamicResource，而不能使用StaticResource：

<Window x:Class="ResourceReferenceDemo.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="资源引用示例" Height="300" Width="400">
    
    <Window.Resources>
        <!-- 样式引用了后面定义的资源，必须使用DynamicResource -->
        <Style x:Key="SpecialButtonStyle" TargetType="Button">
            <Setter Property="Background" Value="{DynamicResource SpecialBrush}"/>
            <Setter Property="Foreground" Value="White"/>
            <Setter Property="Padding" Value="10,5"/>
        </Style>
        
        <!-- 后定义的资源 -->
        <SolidColorBrush x:Key="SpecialBrush" Color="Purple"/>
    </Window.Resources>
    
    <StackPanel Margin="20">
        <Button Content="使用引用了后定义资源的样式" Style="{StaticResource SpecialButtonStyle}" Margin="5"/>
    </StackPanel>
</Window>

资源引用链

我们可以创建资源引用链，一个资源引用另一个资源：

<Window.Resources>
    <!-- 基础颜色资源 -->
    <Color x:Key="BaseColor">#FF0078D7</Color>
    
    <!-- 引用基础颜色的画刷资源 -->
    <SolidColorBrush x:Key="BaseBrush" Color="{StaticResource BaseColor}"/>
    
    <!-- 引用基础画刷的样式资源 -->
    <Style x:Key="BaseButtonStyle" TargetType="Button">
        <Setter Property="Background" Value="{StaticResource BaseBrush}"/>
        <Setter Property="Foreground" Value="White"/>
    </Style>
    
    <!-- 引用基础样式的派生样式 -->
    <Style x:Key="DerivedButtonStyle" TargetType="Button" BasedOn="{StaticResource BaseButtonStyle}">
        <Setter Property="Padding" Value="20,10"/>
        <Setter Property="FontWeight" Value="Bold"/>
    </Style>
</Window.Resources>

实际应用场景

主题切换系统

动态资源非常适合用于实现主题切换功能：

<Application x:Class="ThemeDemo.App"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             StartupUri="MainWindow.xaml">
    <Application.Resources>
        <ResourceDictionary>
            <ResourceDictionary.MergedDictionaries>
                <!-- 默认加载浅色主题 -->
                <ResourceDictionary Source="/Themes/LightTheme.xaml"/>
            </ResourceDictionary.MergedDictionaries>
        </ResourceDictionary>
    </Application.Resources>
</Application>

LightTheme.xaml:

<ResourceDictionary xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
                    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
    <!-- 浅色主题资源 -->
    <Color x:Key="BackgroundColor">#FFFFFF</Color>
    <Color x:Key="ForegroundColor">#333333</Color>
    <Color x:Key="AccentColor">#0078D7</Color>
    
    <SolidColorBrush x:Key="BackgroundBrush" Color="{StaticResource BackgroundColor}"/>
    <SolidColorBrush x:Key="ForegroundBrush" Color="{StaticResource ForegroundColor}"/>
    <SolidColorBrush x:Key="AccentBrush" Color="{StaticResource AccentColor}"/>
    
    <!-- 控件样式 -->
    <Style x:Key="DefaultButtonStyle" TargetType="Button">
        <Setter Property="Background" Value="{DynamicResource AccentBrush}"/>
        <Setter Property="Foreground" Value="White"/>
        <Setter Property="Padding" Value="15,8"/>
    </Style>
</ResourceDictionary>

DarkTheme.xaml:

<ResourceDictionary xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
                    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
    <!-- 深色主题资源 -->
    <Color x:Key="BackgroundColor">#2D2D30</Color>
    <Color x:Key="ForegroundColor">#FFFFFF</Color>
    <Color x:Key="AccentColor">#00BCF2</Color>
    
    <SolidColorBrush x:Key="BackgroundBrush" Color="{StaticResource BackgroundColor}"/>
    <SolidColorBrush x:Key="ForegroundBrush" Color="{StaticResource ForegroundColor}"/>
    <SolidColorBrush x:Key="AccentBrush" Color="{StaticResource AccentColor}"/>
    
    <!-- 控件样式 -->
    <Style x:Key="DefaultButtonStyle" TargetType="Button">
        <Setter Property="Background" Value="{DynamicResource AccentBrush}"/>
        <Setter Property="Foreground" Value="White"/>
        <Setter Property="Padding" Value="15,8"/>
    </Style>
</ResourceDictionary>

多语言支持

动态资源也适用于实现多语言支持：

// 多语言资源切换方法
public void SwitchLanguage(string language)
{
    // 找到当前语言资源字典
    var currentLangDict = Application.Current.Resources.MergedDictionaries
                         .FirstOrDefault(d => d.Source != null && d.Source.OriginalString.Contains("Languages/"));
    
    if (currentLangDict != null)
    {
        // 移除当前语言资源
        Application.Current.Resources.MergedDictionaries.Remove(currentLangDict);
    }
    
    // 添加新的语言资源
    ResourceDictionary langDict = new ResourceDictionary();
    langDict.Source = new Uri($"pack://application:,,,/Resources/Languages/{language}.xaml");
    Application.Current.Resources.MergedDictionaries.Add(langDict);
}

最佳实践与性能考虑

何时使用静态资源

• 应用中固定不变的资源（如基础样式、固定颜色等）
• 对性能要求较高的场景
• 资源在应用生命周期内不需要动态变化
• 大型应用中的基础组件样式

何时使用动态资源

• 主题切换功能
• 多语言支持
• 用户自定义界面设置
• 运行时需要变化的资源
• 对响应性要求高于性能要求的场景

性能优化建议

1. 谨慎使用动态资源：只在确实需要动态变化的场景使用DynamicResource
2. 利用资源引用链：合理设计资源层次，减少重复定义
3. 避免资源泄漏：确保不再需要的资源被清理
4. 预加载资源：对于可能会用到的主题资源，考虑预加载
5. 使用x:Shared属性：对于不需要共享的复杂资源，设置x:Shared=“False”

<!-- 不共享的资源示例 -->
<VisualBrush x:Key="ComplexBrush" x:Shared="False">
    <!-- 复杂绘图内容 -->
</VisualBrush>

常见问题与解决方案

静态资源未找到异常

问题：使用StaticResource但资源未定义导致异常

解决方案：

1. 检查资源键名是否正确
2. 确保资源在正确的作用域定义
3. 考虑使用DynamicResource降低错误严重性

动态资源无法实时更新

问题：更新了资源但界面未响应变化

解决方案：

1. 确认使用的是DynamicResource而非StaticResource
2. 检查资源键是否正确
3. 验证资源替换的代码是否正确执行
4. 考虑手动触发UI更新

// 强制刷新UI的方法
private void ForceUIUpdate()
{
    // 对于窗口，可以调用InvalidateVisual()
    this.InvalidateVisual();
    
    // 对于特定控件，也可以调用其InvalidateVisual()
    myButton.InvalidateVisual();
}

总结

WPF的静态资源与动态资源是资源系统中两种重要的资源引用方式，它们各有优缺点：

• 静态资源(StaticResource)：在XAML加载时一次性解析，性能开销小，但不响应资源变化
• 动态资源(DynamicResource)：在运行时解析，可以响应资源变化，但性能开销较大

在实际应用中，应根据具体需求选择合适的资源引用方式：稳定不变的资源使用StaticResource以获得更好的性能；需要在运行时变化的资源（如主题、语言等）使用DynamicResource以实现动态更新。

合理利用静态资源和动态资源，可以使WPF应用程序既保持良好性能，又具备灵活的动态特性，为用户提供更好的体验。

相关学习资源

• StaticResource标记扩展
• DynamicResource标记扩展
• WPF多语言支持