作为一名WPF开辟者,我迩来在一个设置工具项目中遇到了国际化需求。早先,我只是想让按钮文本支持英文和中文切换,但随着页面增多,需求复杂化,我渐渐探索出一套从简朴到专业化的实现方案。这篇文章记录了我的探索过程,从最底子的资源文件开始,到多页面复用的优化,渴望能给有雷同需求的开辟者一些开导。
第一步:底子实现,资源文件入门
我的项目是一个基于WPF和MVVM的设置工具,界面上有“Save”和“Refresh”两个按钮,须要支持英文和中文切换。WPF的国际化通常从资源文件(.resx)入手,于是我先实行了最简朴的方法。
在项目中,我创建了一个Resources文件夹,添加了两个资源文件:
- Resources.resx(默认英文):
- save: Save
- refresh: Refresh
- Resources.zh-CN.resx(中文):
在XAML中,我实行直接绑定到资源:
- <Button Content="{Binding Source={x:Static local:Resources.save}}" />
复制代码 但很快发现,这种方式在运行时切换语言时不会更新UI,由于静态绑定无法相应动态厘革。于是,我转向代码隐蔽文件,在UserControl中界说属性:
- public partial class PageTemplate : UserControl
- {
- public string Save => Resources.ResourceManager.GetString("save");
- public string Refresh => Resources.ResourceManager.GetString("refresh");
- public PageTemplate()
- {
- InitializeComponent();
- DataContext = this;
- }
- }
复制代码 XAML改为:
- <Button Content="{Binding Save}" />
复制代码 这时间,按钮表现了英文,但点击“中文”按钮后,文本没变。我意识到,语言切换须要更新CultureInfo,于是引入了一个单例类LanguageManager:
- public class LanguageManager
- {
- private static readonly Lazy<LanguageManager> _instance = new Lazy<LanguageManager>(() => new LanguageManager());
- public static LanguageManager Instance => _instance.Value;
- private CultureInfo _currentCulture = new CultureInfo("en-US");
- public CultureInfo CurrentCulture
- {
- get => _currentCulture;
- set
- {
- _currentCulture = value;
- Thread.CurrentThread.CurrentUICulture = value;
- }
- }
- public string GetString(string key) => Resources.ResourceManager.GetString(key, _currentCulture) ?? $"[{key}]";
- }
复制代码 在PageTemplate中使用:
- private readonly LanguageManager _languageManager = LanguageManager.Instance;
- public string Save => _languageManager.GetString("save");
复制代码 加上切换下令:
- <Button CommandParameter="zh-CN" Command="{Binding SwitchLanguageCommand}" Content="中文" />
复制代码- public ICommand SwitchLanguageCommand => new RelayCommand<string>(lang =>
- {
- _languageManager.CurrentCulture = new CultureInfo(lang);
- });
复制代码 然而,切换后UI还是没更新。我调试发现,固然CultureInfo变了,但绑定没有革新。加上INotifyPropertyChanged后标题办理:
- public partial class PageTemplate : UserControl, INotifyPropertyChanged
- {
- private readonly LanguageManager _languageManager = LanguageManager.Instance;
- public string Save => _languageManager.GetString("save");
- public PageTemplate()
- {
- InitializeComponent();
- DataContext = this;
- _languageManager.PropertyChanged += (s, e) => OnPropertyChanged(null);
- }
- public event PropertyChangedEventHandler PropertyChanged;
- protected void OnPropertyChanged(string propertyName) => PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
- }
复制代码 终于,切换语言时按钮文本正常更新了!
第二步:依赖属性,提升WPF体验
固然底子功能实现了,但这种只读属性方式让我以为不敷“WPF”。在WPF中,依赖属性更恰当绑定场景。于是我改用依赖属性:
- public static readonly DependencyProperty SaveProperty = DependencyProperty.Register(
- nameof(Save), typeof(string), typeof(PageTemplate), new PropertyMetadata(string.Empty));
- public string Save
- {
- get => (string)GetValue(SaveProperty);
- set => SetValue(SaveProperty, value);
- }
- public PageTemplate()
- {
- InitializeComponent();
- DataContext = this;
- UpdateLocalizedStrings();
- _languageManager.PropertyChanged += (s, e) => UpdateLocalizedStrings();
- }
- private void UpdateLocalizedStrings()
- {
- Save = _languageManager.GetString("save");
- Refresh = _languageManager.GetString("refresh");
- }
复制代码 如许,绑定更符合WPF的风俗,而且UI更新更可靠。下一步,我把语言切换按钮改成了下拉框:
- <ComboBox ItemsSource="{Binding Languages}"
- DisplayMemberPath="DisplayName"
- SelectedValuePath="CultureName"
- SelectedValue="{Binding SelectedLanguage, Mode=TwoWay}"/>
复制代码- public List<LanguageOption> Languages { get; } = new List<LanguageOption>
- {
- new LanguageOption("English", "en-US"),
- new LanguageOption("中文", "zh-CN")
- };
- public static readonly DependencyProperty SelectedLanguageProperty = DependencyProperty.Register(
- nameof(SelectedLanguage), typeof(string), typeof(PageTemplate),
- new PropertyMetadata("en-US", OnSelectedLanguageChanged));
- public string SelectedLanguage
- {
- get => (string)GetValue(SelectedLanguageProperty);
- set => SetValue(SelectedLanguageProperty, value);
- }
- private static void OnSelectedLanguageChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
- {
- var page = (PageTemplate)d;
- page._languageManager.CurrentCulture = new CultureInfo((string)e.NewValue);
- }
复制代码 这让界面更友好,用户体验也提升了。
第三步:多页面复用,淘汰重复代码
项目发展到有多个页面时,我发现每个页面都重复界说Save、Refresh和语言切换逻辑,太繁琐了。我决定把国际化会合化,先创建了一个基类:
- public class BaseViewModel : INotifyPropertyChanged
- {
- protected readonly LanguageService _languageService = LanguageService.Instance;
- public string Save => _languageService.GetString("save");
- public string Refresh => _languageService.GetString("refresh");
- public event PropertyChangedEventHandler PropertyChanged;
- protected void OnPropertyChanged(string propertyName) => PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
- }
复制代码 LanguageService继续了语言管理:
- public class LanguageService : INotifyPropertyChanged
- {
- private static readonly Lazy<LanguageService> _instance = new Lazy<LanguageService>(() => new LanguageService());
- public static LanguageService Instance => _instance.Value;
- private CultureInfo _currentCulture = new CultureInfo("en-US");
- public CultureInfo CurrentCulture
- {
- get => _currentCulture;
- set
- {
- _currentCulture = value;
- Thread.CurrentThread.CurrentUICulture = value;
- OnPropertyChanged(null);
- }
- }
- public string GetString(string key) => Resources.ResourceManager.GetString(key, _currentCulture) ?? $"[{key}]";
- public List<LanguageOption> Languages { get; } = new List<LanguageOption>
- {
- new LanguageOption("English", "en-US"),
- new LanguageOption("中文", "zh-CN")
- };
- public string SelectedLanguage
- {
- get => _currentCulture.Name;
- set => CurrentCulture = new CultureInfo(value);
- }
- public event PropertyChangedEventHandler PropertyChanged;
- protected void OnPropertyChanged(string propertyName) => PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
- }
复制代码 页面只需继续BaseViewModel:
- public class PageTemplateViewModel : BaseViewModel { }
- public partial class PageTemplate : UserControl
- {
- public PageTemplate()
- {
- InitializeComponent();
- DataContext = new PageTemplateViewModel();
- }
- }
复制代码 XAML绑定到全局服务:
- <ComboBox ItemsSource="{Binding Languages, Source={x:Static services:LanguageService.Instance}}"
- SelectedValue="{Binding SelectedLanguage, Source={x:Static services:LanguageService.Instance}, Mode=TwoWay}"/>
复制代码 第四步:动态化,应对更多字符串
页面越来越多,字符串也从save、refresh扩展到title、user等十几个。我不想在BaseViewModel中为每个字符串写属性,于是实行了动态方案:
- public class BaseViewModel : INotifyPropertyChanged
- {
- protected readonly LanguageService _languageService = LanguageService.Instance;
- public dynamic Strings => new LocalizedStrings(_languageService);
- public BaseViewModel()
- {
- _languageService.PropertyChanged += (s, e) => OnPropertyChanged(nameof(Strings));
- }
- public event PropertyChangedEventHandler PropertyChanged;
- protected void OnPropertyChanged(string propertyName) => PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
- }
- public class LocalizedStrings : DynamicObject
- {
- private readonly LanguageService _languageService;
- public LocalizedStrings(LanguageService languageService)
- {
- _languageService = languageService;
- }
- public override bool TryGetMember(GetMemberBinder binder, out object result)
- {
- result = _languageService.GetString(binder.Name.ToLower());
- return true;
- }
- }
复制代码 XAML改为:
- <Button Content="{Binding Strings.save}" />
- <TextBlock Text="{Binding Strings.title}" />
复制代码 现在,无论有多少字符串,我只需在资源文件里添加键值对,代码完全不消改动。这种方式让我从繁琐的属性界说中解放出来。
总结与反思
从最初的简朴资源文件,到依赖属性,再到多页面复用,末了用动态对象优化,我的国际化之旅走了不少弯路,但每一步都让我更明白WPF和MVVM的精华:
- 起步简朴:资源文件和根本绑定能快速实现单页面国际化。
- 提升体验:依赖属性和下拉框让切换更自然。
- 复用为王:会合化管理克制重复劳动。
- 动态扩展:用动态对象应对将来需求。
如果你的项目也有国际化需求,不妨从底子开始,根据规模徐徐优化。你遇到过哪些国际化困难?接待留言分享!
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!更多信息从访问主页:qidao123.com:ToB企服之家,中国第一个企服评测及商务社交产业平台。 |