MVVM 工具組簡介

套件 CommunityToolkit.Mvvm （也稱為MVVM工具組，先前命名 Microsoft.Toolkit.Mvvm）是現代化、快速且模組化的MVVM連結庫。 它是 .NET 社群工具組的一部分，是以下列原則為基礎所建置：

• 平台和運行時間獨立 - .NET Standard 2.0、 .NET Standard 2.1 和 .NET 6🚀 （UI Framework 無從驗證）
• 易於挑選和使用 - 對應用程式結構或程式代碼架構沒有嚴格的需求（在 'MVVM' ness 之外），也就是彈性的使用方式。
• 笛卡 - 自由選擇要使用的元件。
• 參考實 作 - 精簡且高效能，提供基類連結庫中所含介面的實作，但缺少直接使用它們的具體類型。

MVVM 工具組由 Microsoft 維護及發佈，以及 .NET Foundation 的一部分。 它也會由數個內建於 Windows 的第一方應用程式使用，例如 Microsoft Store。

此套件以 .NET Standard 為目標，使其可用於任何應用程式平臺上：UWP、WinForms、WPF、Xamarin、Uno 等;在任何運行時間：.NET Native、.NET Core、.NET Framework 或 Mono。 它會在它們的所有上執行。 在所有情況下，API 介面都完全相同，因此非常適合用來建置共用連結庫。

此外，MVVM 工具組也有 .NET 6 目標，可用來在 .NET 6 上執行時啟用更多內部優化。 在這兩種情況下，公用 API 介面都相同，因此 NuGet 一律會解決套件的最佳可能版本，而取用者不需要擔心其平臺上會提供哪些 API。

開始使用

若要從 Visual Studio 內安裝套件：

1. 在 方案總管 中，以滑鼠右鍵按兩下專案，然後選取 [管理 NuGet 套件]。 搜尋 CommunityToolkit.Mvvm 並加以安裝。

   

2. 新增 using 或 Imports 指示詞以使用新的 API：

   using CommunityToolkit.Mvvm;
   

   Imports CommunityToolkit.Mvvm
   

3. 程式代碼範例可在MVVM工具組的其他文件頁面，以及專案的單元測試中取得。

我何時應該使用此套件？

使用此套件來存取標準、獨立、輕量型類型的集合，以提供使用MVVM模式建置新式應用程式的起始實作。 這些類型通常足以讓許多使用者建置應用程式，而不需要額外的外部參考。

包含的類型如下：

• CommunityToolkit.Mvvm.ComponentModel
  • ObservableObject
  • ObservableRecipient
  • ObservableValidator
• CommunityToolkit.Mvvm.DependencyInjection
  • Ioc
• CommunityToolkit.Mvvm.Input
  • RelayCommand
  • RelayCommand<T>
  • AsyncRelayCommand
  • AsyncRelayCommand<T>
  • IRelayCommand
  • IRelayCommand<T>
  • IAsyncRelayCommand
  • IAsyncRelayCommand<T>
• CommunityToolkit.Mvvm.Messaging
  • IMessenger
  • WeakReferenceMessenger
  • StrongReferenceMessenger
  • IRecipient<TMessage>
  • MessageHandler<TRecipient, TMessage>
• CommunityToolkit.Mvvm.Messaging.Messages
  • PropertyChangedMessage<T>
  • RequestMessage<T>
  • AsyncRequestMessage<T>
  • CollectionRequestMessage<T>
  • AsyncCollectionRequestMessage<T>
  • ValueChangedMessage<T>

此套件旨在盡可能提供彈性，讓開發人員可以自由選擇要使用的元件。 所有類型都是鬆散結合的，因此只需要包含您使用的內容。 使用這些協助程式建置應用程式時，不需要使用一系列特定的全含 API 進行「全能」，也不需要遵循一組強制模式。 將這些建置組塊結合成最符合您需求的方式。

其他資源

• 查看 範例應用程式 （適用於多個 UI 架構），以查看 MVVM 工具組的運作情形。
• 您也可以在單元測試中找到更多範例。