Einführung in das MVVM-Toolkit

Das CommunityToolkit.Mvvm-Paket (ehemals MVVM Toolkit genannt Microsoft.Toolkit.Mvvm) ist eine moderne, schnelle und modulare MVVM-Bibliothek. Sie ist Teil des .NET Community Toolkits und basiert auf den folgenden Prinzipien:

• Plattform und Runtime Independent - .NET Standard 2.0, .NET Standard 2.1 und .NET 6🚀 (UI Framework Agnostic)
• Einfach zu beginnen und zu verwenden - Keine strengen Anforderungen an Anwendungsstruktur oder Codierungsparadigma (außerhalb von „MVVM“ness), d. h. flexible Nutzung.
• À la carte - Die Freiheit, auszuwählen, welche Komponenten verwendet werden sollen.
• Referenzimplementierung – Schlank und performant, Bereitstellung von Implementierungen für Schnittstellen, die in der Basisklassenbibliothek enthalten sind, aber keine konkreten Typen, um sie direkt zu verwenden.

Das MVVM-Toolkit wird von Microsoft und Teil der .NET Foundation verwaltet und veröffentlicht. Es wird auch von mehreren Erstanbieteranwendungen verwendet, die in Windows integriert sind, z. B. dem Microsoft Store.

Dieses Paket ist auf .NET Standard ausgerichtet, sodass es auf jeder App-Plattform verwendet werden kann: WinUI 3, UWP, WinForms, WPF, Xamarin, Uno und mehr; und auf jeder Laufzeit: .NET Native, .NET Core, .NET Framework oder Mono. Es läuft auf ihnen allen. Die API-Oberfläche ist in allen Fällen identisch und eignet sich perfekt zum Erstellen freigegebener Bibliotheken.

Darüber hinaus verfügt das MVVM-Toolkit auch über ein .NET 6-Ziel, das verwendet wird, um bei der Ausführung auf .NET 6 mehr interne Optimierungen zu ermöglichen. Die öffentliche API-Oberfläche ist in beiden Fällen identisch, sodass NuGet immer die bestmögliche Version des Pakets auflöst, ohne dass sich Nutzer Gedanken darüber machen müssen, welche APIs auf ihrer Plattform verfügbar sind.

Erste Schritte

So installieren Sie das Paket aus Visual Studio:

1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt, und wählen Sie NuGet-Pakete verwalten aus. Suchen Sie nach CommunityToolkit.Mvvm und installieren Sie es.

   

2. Fügen Sie eine „Using“- oder „Imports“-Anweisung hinzu, um die neuen APIs zu verwenden:

   using CommunityToolkit.Mvvm;
   

   Imports CommunityToolkit.Mvvm
   

3. Codebeispiele sind auf den anderen Dokumentationsseiten für das MVVM-Toolkit und in den Komponententests für das Projekt verfügbar.

Wann sollte ich dieses Paket verwenden?

Verwenden Sie dieses Paket für den Zugriff auf eine Sammlung von standardmäßigen, eigenständigen, einfachen Typen, die eine Startimplementierung für die Erstellung moderner Apps mithilfe des MVVM-Musters bieten. Diese Typen allein reichen in der Regel für viele Benutzer aus, um Apps zu erstellen, ohne zusätzliche externe Verweise zu benötigen.

Die enthaltenen Typen sind:

• 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>

Dieses Paket zielt darauf ab, so viel Flexibilität wie möglich zu bieten, sodass Entwickler frei entscheiden können, welche Komponenten verwendet werden sollen. Alle Typen sind lose gekoppelt, sodass es nur erforderlich ist, was Sie verwenden. Es ist weder erforderlich, sich auf eine bestimmte Reihe von allumfassenden APIs festzulegen, noch gibt es eine Reihe von obligatorischen Mustern, die beim Erstellen von Apps mit diesen Helfern befolgt werden müssen. Kombinieren Sie diese Bausteine so, dass sie Ihren Anforderungen am besten entsprechen.

Zusätzliche Ressourcen

• Sehen Sie sich die Beispiel-App (für mehrere UI-Frameworks) an, um das MVVM-Toolkit in Aktion zu sehen.
• Weitere Beispiele finden Sie auch in den Komponententests.