25、Wpf之App资源应用

开发平台:Win10 64位

开发环境:VS2022(64位) Preview

.NET Framework:.NET 6


文章目录

  • [一 Resources](#一 Resources)
    • [1.1 Application中定义资源](#1.1 Application中定义资源)
    • [1.2 样式(Styles)](#1.2 样式(Styles))
    • [1.3 模板(Templates)](#1.3 模板(Templates))
    • [1.4 数据转换器(Converters)](#1.4 数据转换器(Converters))
    • [1.5 资源(Resources)](#1.5 资源(Resources))
  • [二 资源字典(ResourceDictionaries)](#二 资源字典(ResourceDictionaries))
    • [2.1 资源字典的两种定义方式](#2.1 资源字典的两种定义方式)
    • [2.2 使用资源字典](#2.2 使用资源字典)
  • 三、总结
  • 四、参考文献

一 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)是一种资源,它定义了控件的外观和行为。样式可以应用于控件、元素、控件模板、数据模板、触发器、路由事件等。

xaml 复制代码
<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)是一种资源,它定义了控件的结构和布局。模板可以应用于控件、元素、控件模板、数据模板、触发器、路由事件等。

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

1.4 数据转换器(Converters)

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

xaml 复制代码
<Application.Resources>
    <local:MyConverter x:Key="MyConverter" />
</Application.Resources>

1.5 资源(Resources)

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

xaml 复制代码
<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、模板、转换器等资源)。
xaml 复制代码
<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)

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的资源中引用这个资源字典文件

xaml 复制代码
<Application.Resources>
    <ResourceDictionary>
        <ResourceDictionary.MergedDictionaries>
            <ResourceDictionary Source="Styles.xaml" />
        </ResourceDictionary.MergedDictionaries>
    </ResourceDictionary>
</Application.Resources>

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

2.2 使用资源字典

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

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中定义资源字典。
xaml 复制代码
<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换下位置

xaml 复制代码
<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>

四、参考文献

相关推荐
月落.3 小时前
WPF的<ContentControl>控件
wpf
就是有点傻3 小时前
WPF中的依赖属性
开发语言·wpf
wangnaisheng3 小时前
【WPF】把一个Window放在左上角/右上角顶格显示
wpf
WineMonk3 小时前
.NET WPF CommunityToolkit.Mvvm框架
.net·wpf·mvvm
月落.3 小时前
WPF中的INotifyPropertyChanged接口
wpf
界面开发小八哥3 小时前
界面控件DevExpress WPF中文教程:Data Grid——卡片视图设置
.net·wpf·界面控件·devexpress·ui开发
平凡シンプル3 小时前
WPF 打包
wpf
VickyJames3 小时前
基于XAML框架和跨平台项目架构设计的深入技术分析
wpf·开源分享·unoplatform·winui3·项目架构
冷眼Σ(-᷅_-᷄๑)7 小时前
WPF缩放动画和平移动画叠加后会发生什么?
wpf·动画
△曉風殘月〆9 小时前
WPF MVVM入门系列教程(二、依赖属性)
c#·wpf·mvvm