Inleiding tot de MVVM Toolkit

Het CommunityToolkit.Mvvm-pakket (ook wel MVVM Toolkit genoemd, voorheen Microsoft.Toolkit.Mvvm) is een moderne, snelle en modulaire MVVM-bibliotheek. Het maakt deel uit van de .NET Community Toolkit en is gebaseerd op de volgende principes:

• Platform- en runtime-onafhankelijk - .NET Standard 2.0, .NET Standard 2.1 en .NET 6🚀 (onafhankelijk van UI-frameworks)
• Eenvoudig op te halen en te gebruiken - Geen strikte vereisten voor toepassingsstructuur of coderingsparadigma's (buiten 'MVVM'ness), bijvoorbeeld flexibel gebruik.
• À la carte - Vrijheid om te kiezen welke componenten moeten worden gebruikt.
• Referentie-implementatie : Lean en performant, waarbij implementaties worden geboden voor interfaces die zijn opgenomen in de Base Class Library, maar geen concrete typen hebben om ze rechtstreeks te gebruiken.

De MVVM Toolkit wordt onderhouden en gepubliceerd door Microsoft, en onderdeel van de .NET Stichting. Het wordt ook gebruikt door verschillende toepassingen van de eerste partij die zijn ingebouwd in Windows, zoals de Microsoft Store.

Dit pakket is gericht op .NET Standard zodat het kan worden gebruikt op elk app-platform: WinUI 3, UWP, WinForms, WPF, Xamarin, Uno en meer; en op elke runtime: .NET Native, .NET Core, .NET Framework of Mono. Het werkt op ze allemaal. Het API-oppervlak is in alle gevallen identiek, waardoor het perfect is voor het bouwen van gedeelde bibliotheken.

Daarnaast heeft de MVVM Toolkit ook een .NET 6 doel, dat wordt gebruikt om meer interne optimalisaties mogelijk te maken bij het uitvoeren op .NET 6. Het openbare API-oppervlak is in beide gevallen identiek, dus NuGet zal altijd de best mogelijke versie van het pakket oplossen zonder dat consumenten zich zorgen hoeven te maken over welke API's beschikbaar zijn op hun platform.

Aan de slag

Het pakket installeren vanuit Visual Studio:

1. Klik in Solution Explorer met de rechtermuisknop op het project en selecteer NuGet-pakketten beheren. Zoek naar CommunityToolkit.Mvvm en installeer deze.

   

2. Voeg een using- of importrichtlijn toe om de nieuwe API's te gebruiken:

   using CommunityToolkit.Mvvm;
   

   Imports CommunityToolkit.Mvvm
   

3. Codevoorbeelden zijn beschikbaar op de andere docs-pagina's voor de MVVM Toolkit en in de eenheidstests voor het project.

Wanneer moet ik dit pakket gebruiken?

Gebruik dit pakket voor toegang tot een verzameling standaard, zelfstandige, lichtgewicht typen die een start-implementatie bieden voor het bouwen van moderne apps met behulp van het MVVM-patroon. Deze typen zijn meestal voldoende voor veel gebruikers om apps te bouwen zonder extra externe verwijzingen nodig te hebben.

De inbegrepen typen zijn:

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

Dit pakket is erop gericht zoveel mogelijk flexibiliteit te bieden, zodat ontwikkelaars vrij zijn om te kiezen welke onderdelen moeten worden gebruikt. Alle typen zijn los gekoppeld, zodat u alleen hoeft op te nemen wat u gebruikt. Er is geen vereiste om 'all-in' te gaan met een specifieke reeks allesomvattende API's, en er is ook geen set verplichte patronen die moeten worden gevolgd bij het bouwen van apps met behulp van deze helpers. Combineer deze bouwstenen op een manier die het beste bij uw behoeften past.

Aanvullende bronnen

• Bekijk de voorbeeld-app (voor meerdere UI-frameworks) om de MVVM Toolkit in actie te zien.
• U vindt ook meer voorbeelden in de eenheidstests.