Introduktion till MVVM Toolkit

paketet CommunityToolkit.Mvvm (även kallat MVVM Toolkit, som tidigare hette Microsoft.Toolkit.Mvvm) är ett modernt, snabbt och modulärt MVVM-bibliotek. Det är en del av .NET Community Toolkit och bygger på följande principer:

• Plattforms- och körmiljöoberoende - .NET Standard 2.0, .NET Standard 2.1 och .NET 6🚀 (oberoende av UI-ramverk)
• Enkelt att hämta och använda – Inga strikta krav på programstruktur eller kodningsparadigm (utanför MVVM), dvs. flexibel användning.
• À la carte - Frihet att välja vilka komponenter som ska användas.
• Referensimplementering – Lean och performant, som tillhandahåller implementeringar för gränssnitt som ingår i basklassbiblioteket, men som saknar konkreta typer för att använda dem direkt.

MVVM Toolkit underhålls och publiceras av Microsoft och en del av .NET Foundation. Den används också av flera program från första part som är inbyggda i Windows, till exempel the Microsoft Store.

Det här paketet riktar sig till .NET Standard så att det kan användas på valfri appplattform: WinUI 3, UWP, WinForms, WPF, Xamarin, Uno med mera och på alla körningar: .NET Native, .NET Core, .NET Framework eller Mono. Det fungerar på alla. API-ytan är i alla fall identisk, vilket gör den perfekt för att skapa delade bibliotek.

Dessutom har MVVM Toolkit också ett .NET 6 mål, som används för att aktivera fler interna optimeringar vid körning på .NET 6. Den offentliga API-ytan är identisk i båda fallen, så NuGet löser alltid den bästa möjliga versionen av paketet utan att konsumenterna behöver oroa sig för vilka API:er som ska vara tillgängliga på deras plattform.

Komma igång

Så här installerar du paketet från Visual Studio:

1. Högerklicka på projektet i Prieskumník riešení och välj Hantera NuGet-paket. Sök efter CommunityToolkit.Mvvm och installera det.

   

2. Lägg till ett användnings- eller importdirektiv för att använda de nya API:erna:

   using CommunityToolkit.Mvvm;
   

   Imports CommunityToolkit.Mvvm
   

3. Kodexempel är tillgängliga på de andra dokumentsidorna för MVVM Toolkit och i enhetstesterna för projektet.

När ska jag använda det här paketet?

Använd det här paketet för åtkomst till en samling vanliga, fristående, lätta typer som ger en startimplementering för att skapa moderna appar med MVVM-mönstret. Enbart dessa typer räcker vanligtvis för att många användare ska kunna skapa appar utan att behöva ytterligare externa referenser.

De inkluderade typerna är:

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

Det här paketet syftar till att erbjuda så mycket flexibilitet som möjligt, så utvecklare kan välja vilka komponenter som ska användas. Alla typer är löskopplade, så att du bara behöver inkludera det du använder. Det finns inget krav på att gå "all-in" med en specifik serie allomfattande API:er, och det finns inte heller någon uppsättning obligatoriska mönster som måste följas när du skapar appar med hjälp av dessa hjälpfunktioner. Kombinera dessa byggstenar på ett sätt som bäst passar dina behov.

Ytterligare resurser

• Kolla in exempelappen (för flera gränssnittsramverk) för att se MVVM Toolkit i praktiken.
• Du kan också hitta fler exempel i enhetstesterna.