MVVM Toolkit の概要

CommunityToolkit.Mvvm パッケージ (別名 MVVM Toolkit、旧称 Microsoft.Toolkit.Mvvm) は、最新の高速モジュール式 MVVM ライブラリです。 これは .NET Community Toolkit の一部であり、次の原則に基づいて構築されています。

• プラットフォームとランタイムに依存しない - .NET Standard 2.0、.NET Standard 2.1、.NET 6🚀 (UI フレームワークに依存しない)
• 導入と使用が簡単 - アプリケーション構造やコーディングパラダイム ('MVVM' らしさの外側) に関する厳しい要件がないため、柔軟に使用できる。
• アラカルト - 使用するコンポーネントを自由に選択できる。
• リファレンス実装 - 無駄がなくパフォーマンスが高い。基本クラス ライブラリに含まれるインターフェイスの実装を提供するが、それらを直接使用するための具体的な型はない。

MVVM Toolkit は、Microsoft および .NET Foundation の一部により保守および公開されています。 また、Microsoft Store など、Windows に組み込まれているいくつかのファースト パーティ アプリケーションでも使用されます。

このパッケージは .NET Standard を対象としているため、WinUI 3、UWP、WinForms、WPF、Xamarin、Uno などの任意のアプリ プラットフォーム、および任意のランタイム (.NET ネイティブ、.NET Core、.NET Framework、Mono) で使用できます。 これらのいずれにおいても実行できます。 API サーフェスはすべてのケースで同一であるため、共有ライブラリの構築に最適です。

また、MVVM Toolkit には .NET 6 ターゲットもあり、.NET 6 での実行時にさらなる内部最適化を有効にするためにこれが使用されます。 パブリック API サーフェスはどちらのケースでも同じであるため、NuGet は常に、パッケージの最良のバージョンを解決します。プラットフォームで使用できる API がどれかについて、コンシューマーが心配する必要はありません。

作業の開始

Visual Studio 内でパッケージをインストールするには:

1. ソリューション エクスプローラーでプロジェクトを右クリックし、[NuGet パッケージの管理] を選択します。 CommunityToolkit.Mvvm を検索してインストールします。

   

2. 新しい API を使用するために、using または Imports ディレクティブを追加します。

   using CommunityToolkit.Mvvm;
   

   Imports CommunityToolkit.Mvvm
   

3. コード サンプルは、MVVM Toolkit の他のドキュメント ページ、およびプロジェクトの単体テストで入手できます。

このパッケージを使用するタイミング

このパッケージは、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 Toolkit の実際の動作を確認してください。
• 単体テストで、その他の例を確認することもできます。