最近. 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 提供了一系列的功能,使得在 WPF
等程式中實現 MVVM 更加簡單。
ObservableObject
)為實現屬性更改通知提供了基礎結構,簡化了 ViewModel 的建立過程。RelayCommand
),允許 View 以宣告方式繫結到 ViewModel 上的方法。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 的一個簡單範例:
public partial class MainViewModel : ObservableObject
{
[ObservableProperty]
private string title = "Hello, MVVM Toolkit!";
[RelayCommand]
private void DealWithData()
{
// 資料處理邏輯
}
}
ObservableProperty
和 RelayCommand
屬性標記自動處理了屬性更改通知和命令實現的細節,開發者只需關注業務邏輯,並在 XAML 中繫結對應的屬性/命令,元件會自動生成對應的依賴屬性。
注意,請一定使用 camelCase 命名法(可以帶前導_),程式碼生成器會生成符合 PascalCase 標準的屬性/方法名稱。
再看 WeakReferenceMessenger
在不同 ViewModel 或元件間傳送和接收訊息:
首先定義一個訊息型別。訊息可以是任何類或結構,通常包含傳送者想要傳遞的資料:
public class MyMessage
{
public string Text { get; }
public MyMessage(string text)
{
Text = text;
}
}
在一個 ViewModel 或元件中,你可以傳送訊息。假設有一個 SenderViewModel
:
public class SenderViewModel
{
private void SendMessage()
{
var message = new MyMessage("Hello from SenderViewModel");
WeakReferenceMessenger.Default.Send(message);
}
}
SendMessage
方法建立了一個 MyMessage
範例,並通過 WeakReferenceMessenger.Default.Send
方法傳送。
在另一個 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
型別的訊息時,這個接收器將被呼叫。
在不再需要接收訊息時,或者在物件被銷燬之前,應該解除訊息的註冊,以避免記憶體漏失:
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 幫助潤色了部分內容,文章經過人工校對。