25、Wpf之App资源应用

开发平台：Win10 64位
开发环境：VS2022(64位) Preview
.NET Framework：.NET 6

---

一 Resources

wpf资源（Resources）是为了存储一系列我们常复用的对象，每个元素都有Resource属性。其实Resources的定义可以在每一个容器控件中(或者是在每一个控件,在Template 中可以用到),像C#中变量的定义一样,Resource的定义的地方不同决定它的作用范围,如:

• Window.Resources它的作用范围就是在Window容器里的所有子控件有效,也只有这些子控件才能引用/调用这些资源
• Grid.Resources它的作用范围就是在Grid容器里的所有子控件有效,也只有这些子控件才能引用/调用这些资源
  以此类推…

注意:Window不是最上层的"容器",最上层的应该是Appication ,所以Application.Resources 的作用范围更大(有人把Application.Resource叫作全局资源,所有在这个Application下的容器控件等都可以使用,常用来做一个应该程序的Skin ,其ResourceDictionary定义的资源也类似 )

1.1 Application中定义资源

本文以Application.Resources为例，Window和Grid等控件使用资源（Resources）属性和Application类似，可参考Application。
Application.Resources属性是一个非常有用的特性，它允许开发者在应用程序级别集中管理资源，如样式（Styles）、模板（Templates）、数据转换器（Converters）等。这有助于实现一致的设计风格，并且方便维护和更新。

• 样式（Styles）：样式（Styles）：样式是一种资源，它定义了控件的外观和行为。样式可以应用于控件、元素、控件模板、数据模板、触发器、路由事件等。
• 模板（Templates）：模板（Templates）：模板是一种资源，它定义了控件的结构和布局。模板可以应用于控件、元素、控件模板、数据模板、触发器、路由事件等。
• 数据转换器（Converters）：数据转换器是一种资源，它用于转换绑定源和目标之间的绑定值。
• 资源（Resources）：Resources属性是一种资源，它可以包含任意类型的值。
• 资源字典（ResourceDictionaries）：资源字典是一种资源，它可以包含多个样式、模板、数据转换器等资源。

下面是几种常用到的资源的在Application中的定义方式

1.2 样式（Styles）

样式（Styles）是一种资源，它定义了控件的外观和行为。样式可以应用于控件、元素、控件模板、数据模板、触发器、路由事件等。

<Application.Resources><Style x:Key="MyStyle" TargetType="Button"><Setter Property="Background" Value="Red" /><Setter Property="Foreground" Value="White" /><Setter Property="FontSize" Value="16" /></Style>
</Application.Resources>

1.3 模板（Templates）

模板（Templates）是一种资源，它定义了控件的结构和布局。模板可以应用于控件、元素、控件模板、数据模板、触发器、路由事件等。

<Application.Resources><DataTemplate x:Key="MyDataTemplate"><StackPanel><TextBlock Text="{Binding Name}" /><TextBlock Text="{Binding Age}" /></StackPanel></DataTemplate>
</Application.Resources>

1.4 数据转换器（Converters）

数据转换器（Converters）是一种资源，它用于转换绑定源和目标之间的绑定值。

<Application.Resources><local:MyConverter x:Key="MyConverter" />
</Application.Resources>

1.5 资源（Resources）

Resources是一种资源，它可以包含任意类型的值。

<Application.Resources><Color x:Key="MyColor">Red</Color><Thickness x:Key="MyThickness">10</Thickness><FontFamily x:Key="MyFontFamily">Arial</FontFamily><Style x:Key="MyStyle" TargetType="Button"><Setter Property="Background" Value="{StaticResource MyColor}" /><Setter Property="Foreground" Value="White" /><Setter Property="FontSize" Value="16" /></Style>
</Application.Resources>

以上几种方式定义的资源，都可以在XAML文件中使用，但是实际开发中没这么用的，一般都是放在资源字典中用，这样程序的可读写性更好。

二 资源字典（ResourceDictionaries）

2.1 资源字典的两种定义方式

资源字典（ResourceDictionaries）是一种资源，它可以包含多个样式、模板、数据转换器等资源。有两种定义方式：

• 内联定义：在Application.Resources中定义资源字典，并在其中定义其他资源（style、模板、转换器等资源）。

<Application.Resources><ResourceDictionary><Style x:Key="MyStyle" TargetType="Button"><Setter Property="Background" Value="Red" /><Setter Property="Foreground" Value="White" /><Setter Property="FontSize" Value="16" /></Style><DataTemplate x:Key="MyDataTemplate"><StackPanel><TextBlock Text="{Binding Name}" /><TextBlock Text="{Binding Age}" /></StackPanel></DataTemplate><local:MyConverter x:Key="MyConverter" /></ResourceDictionary>
</Application.Resources>

• 外部定义：在外部定义资源字典文件，并在Application.Resources中引用。

单独写一个样式资源字典文件（Styles.xaml）

<ResourceDictionary xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"><Style x:Key="ListBoxItemStyle" TargetType="{x:Type ListBoxItem}"><Setter Property="Background" Value="White" /><Setter Property="BorderBrush" Value="Gray" /><Setter Property="BorderThickness" Value="1" /><Setter Property="Padding" Value="5" /></Style>
</ResourceDictionary>

然后在Application的资源中引用这个资源字典文件

<Application.Resources><ResourceDictionary><ResourceDictionary.MergedDictionaries><ResourceDictionary Source="Styles.xaml" /></ResourceDictionary.MergedDictionaries></ResourceDictionary>
</Application.Resources>

这样就可以在项目中使用ListBoxItem的样式了。

2.2 使用资源字典

因为资源字典定义在了Application中，因此在 XAML 文件中，可以通过控件的属性中设置资源的引用。

<Button Content="Click Me" Style="{StaticResource MyStyle}" />
<DataTemplate x:Key="MyDataTemplate"><StackPanel><TextBlock Text="{Binding Name}" /><TextBlock Text="{Binding Age}" /></StackPanel>
</DataTemplate>
<local:MyConverter x:Key="MyConverter" />
<Color x:Key="MyColor">Red</Color>
<Thickness x:Key="MyThickness">10</Thickness>
<FontFamily x:Key="MyFontFamily">Arial</FontFamily>

在上面的例子中，我们定义了三个资源：MyStyle、MyDataTemplate、MyConverter。然后在按钮的 Content 属性中引用了 MyStyle，在 DataTemplate 的 DataTemplate 属性中引用了 MyDataTemplate，在 local:MyConverter 的 Converter 属性中引用了 MyConverter，在 Color、Thickness、FontFamily 的值中引用了 MyColor、MyThickness、MyFontFamily。

三、总结

当多个资源具有相同的名称时，WPF 会按照以下优先级来确定资源的使用：

• 样式（Styles）> 模板（Templates）> 数据转换器（Converters）> 资源字典（ResourceDictionaries）> 资源（Resources）

也就是说，如果有多个资源具有相同的名称，WPF 会按照样式、模板、数据转换器、资源字典、资源的顺序来确定使用哪个资源。
对于大型项目或者模块化开发，我们通常会把一些公共的样式、模板、数据转换器、资源字典等资源定义在单独的资源字典文件中，就是2.1中的外部定义方式，并通过引用的方式在项目中使用。这样可以避免资源的重复定义，提高代码的可维护性。比如我们会用到的控件样式，

在资源字典的使用中有些错误，下面是笔者遇到的

• 内联方式：在Application.Resources中定义资源字典。

<Application.Resources><ResourceDictionary><Style x:Key="MyStyle" TargetType="Button"><Setter Property="Background" Value="Red" /> </Style><DataTemplate x:Key="MyDataTemplate"><StackPanel><TextBlock Text="{Binding Name}" /><TextBlock Text="{Binding Age}" /></StackPanel></DataTemplate><local:GenderConverter x:Key="GenderConverter" /></ResourceDictionary><!--样式（Styles）--><Style x:Key="MyStyle" TargetType="Button"><Setter Property="Background" Value="Red" /><Setter Property="Foreground" Value="White" /><Setter Property="FontSize" Value="16" /></Style>
</Application.Resources>

把Style和ResourceDictionary换下位置

<Application.Resources><!--样式（Styles）-->
<Style x:Key="MyStyle" TargetType="Button"><Setter Property="Background" Value="Red" /><Setter Property="Foreground" Value="White" /><Setter Property="FontSize" Value="16" />
</Style>
<ResourceDictionary><Style x:Key="MyStyle" TargetType="Button"><Setter Property="Background" Value="Red" /><Setter Property="Foreground" Value="White" /><Setter Property="FontSize" Value="16" /></Style><DataTemplate x:Key="MyDataTemplate"><StackPanel><TextBlock Text="{Binding Name}" /><TextBlock Text="{Binding Age}" /></StackPanel></DataTemplate><local:GenderConverter x:Key="GenderConverter" />
</ResourceDictionary>
</Application.Resources>

需要给ResourceDictionary一个key值

<ResourceDictionary x:Key="1">

这个时候是正常的，这个就是说，需要把资源字典（ResourceDictionary ）放在其他的资源（style、模板、转换器等）的后面

个人观点：对于Application.Resources来说，styel、模板、转换器、资源字典都是一样的，所以需要像Style、DataTemplate一样添加key，不然在使用的时候没法区分是哪个资源字典

同时写两个即使填写了key也会报错，因为两个类型一样，就如同给Button控件设置了两次Content属性一样。但是在这两个ResourceDictionary 前面添加一个其他的资源（style、模板、转换器等），就不报错了，很费解。。。。。。

• 引用外部定义的资源字典
  这个时候在Application.Resources节点下只写一个ResourceDictionary，没有style、模板、转换器等，且不对ResourceDictionary设置key
  如果设置了key就会报如下错误。去掉key="1"就可以了
  
  这样，<Application.Resources>下面只有一个节点，这个节点里面包含了其他资源。

<Application.Resources><ResourceDictionary ><Style x:Key="MyStyle" TargetType="Button"><Setter Property="Background" Value="Red" /><Setter Property="Foreground" Value="White" /><Setter Property="FontSize" Value="16" /></Style><DataTemplate x:Key="MyDataTemplate"><StackPanel><TextBlock Text="{Binding Name}" /><TextBlock Text="{Binding Age}" /></StackPanel></DataTemplate><local:GenderConverter x:Key="GenderConverter" /></ResourceDictionary>
</Application.Resources>

进一步的引用外部定义的资源字典,这个结构是<Application.Resources>下面只有一个节点，这个节点里面除了包含style、模板、转换器等资源外还添加了外部资源字典，这个外部资源字典被合并到一起了，统一在<ResourceDictionary.MergedDictionaries>这个节点下面，和上面的不同点是<ResourceDictionary.MergedDictionaries>充当了Style、DataTemplate等资源的角色。

<Application.Resources> <ResourceDictionary><ResourceDictionary.MergedDictionaries><ResourceDictionary Source="pack://application:,,,/MaterialDesignThemes.Wpf;component/Themes/MaterialDesignTheme.Light.xaml" /><ResourceDictionary Source="pack://application:,,,/MaterialDesignThemes.Wpf;component/Themes/MaterialDesign3.Defaults.xaml" /><ResourceDictionary Source="pack://application:,,,/MaterialDesignColors;component/Themes/Recommended/Primary/MaterialDesignColor.DeepPurple.xaml" /><ResourceDictionary Source="pack://application:,,,/MaterialDesignColors;component/Themes/Recommended/Secondary/MaterialDesignColor.Lime.xaml" /><ResourceDictionary Source="pack://application:,,,/BlankApp1;component/Res/Geometry.xaml"/><ResourceDictionary Source="pack://application:,,,/BlankApp1;component/Res/Style.xaml"/><ResourceDictionary Source="pack://application:,,,/BlankApp1;component/Res/Colors.xaml"/><ResourceDictionary Source="pack://application:,,,/BlankApp1;component/Res/DataGrid.xaml"/><ResourceDictionary><convert:VisibilityToInverseVisibilityConverter x:Key="InverseVisibility"/></ResourceDictionary></ResourceDictionary.MergedDictionaries><!--样式（Styles）--><Style x:Key="MyStyle" TargetType="Button"><Setter Property="Background" Value="Red" /><Setter Property="Foreground" Value="White" /><Setter Property="FontSize" Value="16" /></Style><!--模板（Templates）--><DataTemplate x:Key="MyDataTemplate"><StackPanel><TextBlock Text="{Binding Name}" /><TextBlock Text="{Binding Age}" /></StackPanel></DataTemplate><!--数据转换器（Converters）--><convert:VisibilityToInverseVisibilityConverter x:Key="InverseVisibility"/><!--资源（Resources）--><Color x:Key="MyColor">Red</Color><Thickness x:Key="MyThickness">10</Thickness><FontFamily x:Key="MyFontFamily">Arial</FontFamily></ResourceDictionary>  
</Application.Resources>

四、参考文献

• 4.1 https://blog.csdn.net/hustlei/article/details/86699209