从零到多页复用：我的WPF MVVM国际化实践

文章目录

作为一名WPF开发者，我最近在一个配置工具项目中遇到了国际化需求。起初，我只是想让按钮文本支持英文和中文切换，但随着页面增多，需求复杂化，我逐渐摸索出一套从简单到专业化的实现方案。这篇文章记录了我的探索过程，从最基础的资源文件开始，到多页面复用的优化，希望能给有类似需求的开发者一些启发。

第一步：基础实现，资源文件入门

我的项目是一个基于WPF和MVVM的配置工具，界面上有"Save"和"Refresh"两个按钮，需要支持英文和中文切换。WPF的国际化通常从资源文件（.resx）入手，于是我先尝试了最简单的方法。

在项目中，我创建了一个Resources文件夹，添加了两个资源文件：

Resources.resx（默认英文）：
- save: Save
- refresh: Refresh
Resources.zh-CN.resx（中文）：
- save: 保存
- refresh: 刷新

在XAML中，我尝试直接绑定到资源：

xml 复制代码

<Button Content="{Binding Source={x:Static local:Resources.save}}" />

但很快发现，这种方式在运行时切换语言时不会更新UI，因为静态绑定无法响应动态变化。于是，我转向代码隐藏文件，在UserControl中定义属性：

csharp 复制代码

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改为：

xml 复制代码

<Button Content="{Binding Save}" />

这时候，按钮显示了英文，但点击"中文"按钮后，文本没变。我意识到，语言切换需要更新CultureInfo，于是引入了一个单例类LanguageManager：

csharp 复制代码

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中使用：

csharp 复制代码

private readonly LanguageManager _languageManager = LanguageManager.Instance;
public string Save => _languageManager.GetString("save");

加上切换命令：

xml 复制代码

<Button CommandParameter="zh-CN" Command="{Binding SwitchLanguageCommand}" Content="中文" />

csharp 复制代码

public ICommand SwitchLanguageCommand => new RelayCommand<string>(lang =>
{
    _languageManager.CurrentCulture = new CultureInfo(lang);
});

然而，切换后UI还是没更新。我调试发现，虽然CultureInfo变了，但绑定没有刷新。加上INotifyPropertyChanged后问题解决：

csharp 复制代码

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中，依赖属性更适合绑定场景。于是我改用依赖属性：

csharp 复制代码

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更新更可靠。下一步，我把语言切换按钮改成了下拉框：

xml 复制代码

<ComboBox ItemsSource="{Binding Languages}"
          DisplayMemberPath="DisplayName"
          SelectedValuePath="CultureName"
          SelectedValue="{Binding SelectedLanguage, Mode=TwoWay}"/>

csharp 复制代码

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和语言切换逻辑，太繁琐了。我决定把国际化集中化，先创建了一个基类：

csharp 复制代码

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接管了语言管理：

csharp 复制代码

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：

csharp 复制代码

public class PageTemplateViewModel : BaseViewModel { }
public partial class PageTemplate : UserControl
{
    public PageTemplate()
    {
        InitializeComponent();
        DataContext = new PageTemplateViewModel();
    }
}

XAML绑定到全局服务：

xml 复制代码

<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中为每个字符串写属性，于是尝试了动态方案：

csharp 复制代码

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改为：

xml 复制代码

<Button Content="{Binding Strings.save}" />
<TextBlock Text="{Binding Strings.title}" />

现在，无论有多少字符串，我只需在资源文件里添加键值对，代码完全不用改动。这种方式让我从繁琐的属性定义中解放出来。

总结与反思

从最初的简单资源文件，到依赖属性，再到多页面复用，最后用动态对象优化，我的国际化之旅走了不少弯路，但每一步都让我更理解WPF和MVVM的精髓：

起步简单：资源文件和基本绑定能快速实现单页面国际化。
提升体验：依赖属性和下拉框让切换更自然。
复用为王：集中化管理避免重复劳动。
动态扩展：用动态对象应对未来需求。

如果你的项目也有国际化需求，不妨从基础开始，根据规模逐步优化。你遇到过哪些国际化难题？欢迎留言分享！