使用MVVM Toolkit簡化WPF開發

最近. NET 8 的 WPF 推出了 WPF File Dialog改進,這樣無需再引用 Win32 命名空間就可以實現文件夾的選擇與存儲了,算是一個很方便的改進了。順手寫了一個小的 WPF 程序,在使用 Model-View-ViewModel(MVVM) 模式的時候,我不想使用 Prism 等重量級的框架,找了一個輕量級的 MVVM Community Toolkit (以下簡稱 MVVM Toolkit)。

在現代 WPF 應用程序開發中,遵循 MVVM(Model-View-ViewModel)模式已成爲一種標準做法。MVVM 模式視圖和邏輯分離,提高了代碼的可測試性、可維護性。

MVVM Toolkit 核心功能

MVVM Toolkit 提供了一系列的功能,使得在 WPF 等程序中實現 MVVM 更加簡單。

  1. ViewModel 基類:基類(例如 ObservableObject)爲實現屬性更改通知提供了基礎結構,簡化了 ViewModel 的創建過程。
  2. 命令的實現:MVVM Toolkit 提供了易於使用的命令實現(RelayCommand ),允許 View 以聲明方式綁定到 ViewModel 上的方法。
  3. 弱消息機制:弱消息機制(WeakReferenceMessenger)允許不同對象之間收發消息,而不會造成內存泄漏。

安裝

使用 nuget 安裝到 WPF 項目中即可。由於 MVVM Toolkit 面向. NET Standard,所以可在任何應用平臺上使用:UWP、WinForms、WPF、Xamarin、Uno 等。

Install-Package CommunityToolkit.Mvvm

代碼生成

在 MVVM Toolkit 中,代碼生成器扮演着重要的角色。通過利用代碼生成器,它能夠自動化諸如屬性更改通知和命令實現等常見任務,減少樣板代碼,提高開發效率。

例如,開發者可以通過簡單的屬性標記,自動實現 INotifyPropertyChanged 接口:

partial class MyViewModel : ObservableObject
 {
     [ObservableProperty]
     private string name;

     [ObservableProperty]
     private bool isEnabled;
 }

以上代碼會通過 Roslyn 的代碼生成器功能生成如下代碼:

 partial class MyViewModel
 {
     public string Name
     {
         get => name;
         set => SetProperty(ref name, value);
     }

     public bool IsEnabled
     {
         get => isEnabled;
         set => SetProperty(ref isEnabled, value);
     }
 }

在沒有 MVVM Toolkit 的情況下,開發者需要手動實現 MVVM 的各個部分。例如,實現 INotifyPropertyChanged 接口通常涉及創建大量樣板代碼:

public class MyViewModel : INotifyPropertyChanged
{
    private string myProperty;

    public string MyProperty
    {
        get => myProperty;
        set
        {
            myProperty = value;
            OnPropertyChanged(nameof(MyProperty));
        }
    }

    public event PropertyChangedEventHandler PropertyChanged;

    protected virtual void OnPropertyChanged(string propertyName)
    {
        PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
    }
}

相比之下,MVVM Toolkit 不僅減少了需要編寫的代碼量,也降低了出錯的可能性,使得開發更加專注於業務邏輯本身。

使用 MVVM Toolkit 創建 ViewModel

依賴屬性與命令

以下是使用 MVVM Toolkit 創建 ViewModel 的一個簡單示例:

public partial class MainViewModel : ObservableObject
{
    [ObservableProperty]
    private string title = "Hello, MVVM Toolkit!";

    [RelayCommand]
    private void DealWithData()
    {
        // 數據處理邏輯
    }
}

ObservablePropertyRelayCommand 屬性標記自動處理了屬性更改通知和命令實現的細節,開發者只需關注業務邏輯,並在 XAML 中綁定對應的屬性/命令,組件會自動生成對應的依賴屬性。

注意,請一定使用 camelCase 命名法(可以帶前導_),代碼生成器會生成符合 PascalCase 標準的屬性/方法名稱。

弱引用消息

再看 WeakReferenceMessenger 在不同 ViewModel 或組件間發送和接收消息:

1. 定義消息類型

首先定義一個消息類型。消息可以是任何類或結構,通常包含發送者想要傳遞的數據:

public class MyMessage
{
    public string Text { get; }

    public MyMessage(string text)
    {
        Text = text;
    }
}

2. 發送消息

在一個 ViewModel 或組件中,你可以發送消息。假設有一個 SenderViewModel

public class SenderViewModel
{
    private void SendMessage()
    {
        var message = new MyMessage("Hello from SenderViewModel");
        WeakReferenceMessenger.Default.Send(message);
    }
}

SendMessage 方法創建了一個 MyMessage 實例,並通過 WeakReferenceMessenger.Default.Send 方法發送。

3. 接收消息

在另一個 ViewModel 或組件中,你可以註冊以接收特定類型的消息。例如,你可能有一個 ReceiverViewModel

public class ReceiverViewModel
{
    public ReceiverViewModel()
    {
        // 註冊以接收 MyMessage 類型的消息
        WeakReferenceMessenger.Default.Register<MyMessage>(this, (recipient, message) =>
        {
            // 處理接收到的消息
            string receivedText = message.Text;
            // Do something with receivedText
        });
    }
}

ReceiverViewModel 的構造函數中,使用 WeakReferenceMessenger.Default.Register 方法註冊了消息接收器,當發送方發送 MyMessage 類型的消息時,這個接收器將被調用。

4. 解除消息註冊

在不再需要接收消息時,或者在對象被銷燬之前,應該解除消息的註冊,以避免內存泄漏:

public class ReceiverViewModel
{
    public ReceiverViewModel()
    {
        WeakReferenceMessenger.Default.Register<MyMessage>(this, OnMessageReceived);
    }

    private void OnMessageReceived(object recipient, MyMessage message)
    {
        // 處理消息
    }

    ~ReceiverViewModel()
    {
        WeakReferenceMessenger.Default.Unregister<MyMessage>(this);
    }
}

ReceiverViewModel 通過其析構函數取消註冊(也可以使用 IDispose 實現),確保當 ViewModel 被回收時,不會有消息處理器的引用殘留。

總結

MVVM Toolkit 爲 WPF 開發者提供了一個強大且易用的工具,它極大地簡化了 MVVM 模式實現過程,雖然其他框架(MVVM Light/Prism 等)也提供了類似功能,但它非常輕量,使用簡單,非常適合小型工程使用。

本文使用 AI 幫助潤色了部分內容,文章經過人工校對。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章