怎样实现WPF Prism Module的国际化和本地化?

English | 简体中文

上一篇有简单介绍主工程的国际化,使用的资源字典(XAML)实现的。这几天我添加了几个Prism模块(Module),发现子模块使用资源字典的方式实现国际化和本地化不好做,没有找到比较好的参考文章,所以换了一种方式,使用资源文件实现了。

让WPF项目走上国际化路线

一、本文概述

子模块的国际化和本地化要求:

  • 各模块需要有自己单独的语言文件。

  • 在主工程中动态切换语言时,子模块也需要跟着切换。

  • 使用了Prism实现模块化框架,即要求主工程与各子模块不能有引用关系,即松耦合,不能直接在主工程中切换子模块的语言文件。

基于上面的要求,我尝试在各模块(Module)中也定义了语言文件(XAML),主窗体切换语言时,加载模块语言文件老是提示不存在对应的资源字典文件,我恼火呀,后面还是参考“Accelerider.Windows”国际化的方式,使用资源文件实现本地化和国际化了,不纠结Xaml的方式了,唉。

此路不通,我换条路走

下面是修改后的效果:

和上一版异同:

  • 标题栏国际化无变化,只是文字绑定换了种方式,实现效果一致。

  • 左侧添加了三个子模块(Home\Client\Server),使用Prism动态加载的,并且跟随主工程主窗体语言切换而切换语言。

下面简单介绍怎么创建模块,以及主窗体和模块国际化怎么做的,真的是很简单的介绍,具体的实现可以拉代码看看。

跌到,爬起来,继续趟坑

二、 添加三个Prism模块(Module)

可安装Prism模板,快速创建模块工程,当然手工创建.Net Core工程也是可以的,就是多了几个步骤而已(需要用Nuget安装Prism.Wpf包(7.2.0.1422)),我使用得的Prism模板快速创建的。

2.1 创建模块之前的准备工作

VS2019下载Prism模板

下载上图搜索到的Prism模板,重启VS,它会自动安装,新建项目时,就有Prism模块模板选择了:

Prism模板工程

注意要选择.NET Core 3的版本,因为我是使用.NET Core创建的WPF项目。

2.2 创建模块

下面是已经创建好的三个模块工程截图:

目前三个模块文件组织结构类似:

  • I18nResources:资源文件夹,放3个语言资源文件和一个T4模板文件(用于引用语言Key),其中T4模板文件在3个模块和主工程中定义是一样的,具体可从github下载源码查看。

  • Views放置视图文件,现在只使用到了主工程主窗体中显示的TabItem视图,即MainTabItem.xaml,继承自TabItem。

  • xxxxModule.cs:prism模板定义文件,prism发现模块使用。

三个模块关键点需要注意:

  • 1. 编辑模块工程文件,修改模块文件输出目录:

// 省略部分代码,下面这一行设置为False,代表输出目录不带.NET Core版本信息
<AppendTargetFrameworkToOutputPath>Flase</AppendTargetFrameworkToOutputPath>
// 省略部分代码,修改Debug与Release编译输出目录,方便主工程统一加载模块
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|AnyCPU'"><OutputPath>..\Build\Debug\Modules</OutputPath>
</PropertyGroup>
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|AnyCPU'"><OutputPath>..\Build\Release\Modules</OutputPath>
</PropertyGroup>  
// 省略部分代码
  • 2. XXXModule中需要将资源文件的ResourceManager引用添加到另一个库中保存,待切换语言时需要使用,如在HomeModule的构造函数中添加代码如下,只添加这一句代码就好,模块的国际化及本地化就算完事了:

I18nManager.Instance.Add(TerminalMACS.Home.I18nResources.UiResource.ResourceManager);
  • 3. XXXModule的RegisterTypes方法中注册视图"MainTabItem"到"RegionNames.MainTabRegion",主窗体使用"RegionNames.MainTabRegion"关联模块视图显示加载。

_regionManager.RegisterViewWithRegion(RegionNames.MainTabRegion, typeof(MainTabItem));
  • 4. UI控件国际化文字绑定,其中markup使用的一个开源库命名空间,后面会给出链接,本项目直接将该库加载进了解决方案中;i18NResources:Language即T4模板文件生成的类,关联文字翻译的Key。绑定文字部分代码如下:

<TextBlock Grid.Row="2" Text="{markup:I18n {x:Static i18NResources:Language.MainTabItm_Header}}"

三、 主工程

主工程目录组织结构如下:

3.1 动态加载Prism模块

配置加载3个模块的关键代码在App.xaml.cs文件中,看上面的代码,我将三个模块输出到了Modules目录下,主工程直接加载此目录即可,其他加载方式还有使用配置文件等,可以参考Prism官方例子,文末给出链接:

protected override IModuleCatalog CreateModuleCatalog()
{string modulePath = @".\Modules";if (!Directory.Exists(modulePath)){Directory.CreateDirectory(modulePath);}return new DirectoryModuleCatalog() { ModulePath = modulePath };
}

主窗体显示子模块注册的TabItem视图,prism:RegionManager.RegionName即在各子模块中注册过的区域字符串,他与模块对应的TabItem视图关联,代码如下:

<TabControl Grid.ColumnSpan="2" SelectedIndex="0"Style="{StaticResource MainTabControlStyle}" ItemContainerStyle="{StaticResource MainTabItemStyle}"prism:RegionManager.RegionName="{x:Static ui:RegionNames.MainTabRegion}"/>

主窗体以TabControl的控件形式展示子模块视图:

子模块的TabItem视图

主工程要能正常加载子模块,主工程的工程文件也需要修改其输出目录:

// 省略部分代码,下面这一行设置为False,代表输出目录不带.NET Core版本信息
<AppendTargetFrameworkToOutputPath>Flase</AppendTargetFrameworkToOutputPath>
// 省略部分代码,修改Debug与Release编译输出目录,方便主工程统一加载模块
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|AnyCPU'"><OutputPath>..\Build\Debug</OutputPath>
</PropertyGroup>
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|AnyCPU'"><OutputPath>..\Build\Release</OutputPath>
</PropertyGroup>  
// 省略部分代码

3.2 修改语言文件格式

删除了原有的XAML语言文件,替换为resx的资源文件,和三个模块的资源文件类型类似,下面是主工程的资源文件:

资源文件作为语言文件使用

替换成资源文件,编辑是要比XAML文件要方便点,起初是有考虑使用资源文件实现国际化的,作死想尝试XAML文件。

折腾是可以涨姿势的

3.3 语言切换核心代码

动态切换语言的关键代码改为:

public static void SetLanguage(string language = "")
{if (string.IsNullOrWhiteSpace(language)){language = ConfigHelper.ReadKey(KEY_OF_LANGUAGE);if (string.IsNullOrWhiteSpace(language)){language = System.Globalization.CultureInfo.CurrentCulture.ToString();}}ConfigHelper.SetKey(KEY_OF_LANGUAGE, language);_lastLanguage = language;var culture = new System.Globalization.CultureInfo(language);I18nManager.Instance.CurrentUICulture = culture;
}

核心的语言切换代码是最后一句,不详细说了,解决方案中有库、有源码:

I18nManager.Instance.CurrentUICulture = culture;

四. 源码

关于
  • 源码地址,欢迎star:https://github.com/dotnet9/TerminalMACS/tree/master/src/TerminalMACS.Manager/TerminalMACS.ManagerForWPF

  • 官方网站:https://terminalmacs.com

  • 合作网站:https://dotnet9.com

四. 参考资料

  • Prism Template Pack(Prism模板):https://marketplace.visualstudio.com/items?itemName=BrianLagunas.PrismTemplatePack

  • WPF国际化开源辅助库:https://github.com/DingpingZhang/WpfExtensions

  • Accelerider.Windows(子模块加载参考开源项目):https://github.com/Accelerider/Accelerider.Windows

  • Prism-Samples-Wpf(官方Demo):https://github.com/PrismLibrary/Prism-Samples-Wpf

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/news/310424.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

dotNET Core 3.X 使用 Jwt 实现接口认证

在前后端分离的架构中&#xff0c;前端需要通过 API 接口的方式获取数据&#xff0c;但 API 是无状态的&#xff0c;没有办法知道每次请求的身份&#xff0c;也就没有办法做权限的控制。如果不做控制&#xff0c;API 就对任何人敞开了大门&#xff0c;只要拿到了接口地址就可以…

数据结构与算法--代码鲁棒性案例分析

代码鲁棒性 鲁棒是robust的音译&#xff0c;就是健壮性。指程序能够判断输入是否符合规范&#xff0c;对不合要求的输入能够给出合理的结果。容错性是鲁棒的一个重要体现。不鲁棒的代码发生异常的时候&#xff0c;会出现不可预测的异常&#xff0c;或者程序奔溃。由于鲁棒性非…

【半译】两个gRPC的C#库:grpc-dotnet vs Grpc.Core

grpc-dotnet 是在2019年随着 .NET Core 3.0 一起发布的一个gPRC官方库。在ASP.NET Core 的 gRPC项目模板里面就使用了这个库。.NET Core 3.0之前难道不可以使用gRPC吗&#xff1f;目前&#xff0c;gRPC 在.NET上有两种官方实现&#xff1a;Grpc.Core&#xff1a;这个是原来的gR…

[Java基础]String对象的特点(易错点)

String对象的特点: 1.通过new创建的字符串对象&#xff0c;每一次new都会申请一个内存空间&#xff0c;虽然内容相同&#xff0c;但是地址值不同。 2.以""方式给出的字符串&#xff0c;只要字符串相同(顺序和大小写)&#xff0c;无论在程序代码中出现几次&#xff0…

数据结构与算法--解决问题的方法- 二叉树的的镜像

解决问题的思路 工作中遇到的问题可能用到的数据结构由很多&#xff0c;并且各种数据结构都不简单&#xff0c;我们不可能光凭借想象就能得到问题的解法&#xff0c;因此画图是在家具问题过程中用来帮助自己分析&#xff0c;推理的常用手段。很多问题比较抽象&#xff0c;不容…

使用dnSpy调试asp.net core源码

环境&#xff1a;window 10vs2019 16.5.1dnspy v6.1.4.netcore3.1参考&#xff1a;.Net反编译技术详解及4个反编译工具介绍一、关于dnSpydnSpy是近几年的新秀&#xff0c;功能远比ILSpy强大&#xff0c;甩.net Reflector几条街&#xff0c;被汉化、破解、逆向方面的人才奉为神器…

数据结构与算法--解决问题的方法-顺时针打印矩阵

顺时针打印矩阵 题目输入一个矩阵&#xff0c;按照从外向里顺时针的顺序依次打印每一个数字。例如下案例&#xff1a; 如上图矩阵&#xff0c;顺时针打印&#xff1a;1,2,3,4,8,12,16,15,14,13,9,5,6,7,1,10 以上问题看起来比较复杂&#xff0c;但是又没有涉及到复杂的数据结…

.NET与鲲鹏共展翅,昇腾九万里(二)

在上一篇文章 .NET与鲲鹏共展翅&#xff0c;昇腾九万里&#xff08;一&#xff09;中&#xff0c;我们通过在鲲鹏架构的Euler系统上跑Docker的方式把dotnet core 跑起来了&#xff0c;有读者反馈说“还是走docker喽&#xff0c;你这个标题应该改成鲲鹏和docker两条鲸鱼的故事”…

[Java基础]final和static修饰符

final: final修饰局部变量时: static&#xff1a; static访问特点:

优化委托的 DynamicInvoke

优化委托的 DynamicInvokeIntro委托方法里有一个 DynamicInvoke 的方法&#xff0c;可以在不清楚委托实际类型的情况下执行委托方法&#xff0c;但是用 DynamicInvoke 去执行的话会比直接用 Invoke 的方法会慢上很多&#xff0c;差了两个数量级&#xff0c;所以在知道委托类型的…

数据结构与算法-- 广度优先打印二叉树

广度优先打印二叉树 题目&#xff1a;从上往下打印出二叉树的每一个节点&#xff0c;同一层节点按照从左到右顺序打印&#xff0c;例如下图中二叉树&#xff0c;依次打印出是8,6,10,5,7,9,11 如上题中二叉树的节点定义我们用之前文章 二叉树实现原理中定义的节点结构。此处提议…

实现一个基于动态代理的 AOP

实现一个基于动态代理的 AOPIntro上次看基于动态代理的 AOP 框架实现&#xff0c;立了一个 Flag&#xff0c; 自己写一个简单的 AOP 实现示例&#xff0c;今天过来填坑了目前的实现是基于 Emit 来做的&#xff0c;后面有时间再写一个基于 Roslyn 来实现的示例效果演示演示代码&…

数据结构与算法-- 二叉树后续遍历序列校验

二叉树后续遍历序列校验 题目&#xff1a;输入一个整数数组&#xff0c;判断改数组是否是某个二叉搜索树的后续遍历结果&#xff0c;如果是返回true否则false&#xff0c;假设输入数组的任意两个数字不相同。 例如输入{5,7,6,9,11,10,8}则返回true&#xff0c;因为这个整数序列…

程序员过关斩将-- 工作好多年可能还未真正了解接口和抽象类

点击上方“蓝字”关注我们菜菜哥&#xff0c;我偷偷出去面试了&#xff0c;然后面试官让我回来等消息那你可能挂了呀&#xff0c;有什么问题没回答上来吗确实有一个问题回答的不太好哎&#xff0c;就是接口和抽象类这个确实是面试官比较爱问的题目之一那能不能说说接口和抽象类…

数据结构与索引-- mysql InnoDB存储引擎索引

索引与算法 索引是我们在应用开发过程中程序数据可开发的一个重要助力。也是一个重要的研究方向&#xff0c;索引太多&#xff0c;应用的性能可能受到影响&#xff0c;如果索引太少&#xff0c;对查询性能又会有制约。我们需要找到一个合适的平衡点&#xff0c;这个对性能至关…