Introduzione a MVVM Toolkit

Il CommunityToolkit.Mvvm pacchetto (noto anche come MVVM Toolkit, denominato Microsoft.Toolkit.Mvvmin precedenza ) è una libreria MVVM moderna, veloce e modulare. Fa parte di .NET Community Toolkit e si basa sui principi seguenti:

• Indipendente dalla piattaforma e dal runtime - .NET Standard 2.0, .NET Standard 2.1 e .NET 6🚀 (indipendente dal framework dell'interfaccia utente)
• Semplice da raccogliere e usare : nessun requisito rigoroso per la struttura dell'applicazione o i paradigmi di codifica (al di fuori di 'MVVM'ness), ovvero l'utilizzo flessibile.
• À la carte - Libertà di scegliere quali componenti utilizzare.
• Implementazione di riferimento - Snella e performante, fornisce implementazioni per le interfacce incluse nella Base Class Library, ma che non dispongono di tipi concreti per essere utilizzate direttamente.

MVVM Toolkit viene gestito e pubblicato da Microsoft e parte di .NET Foundation. Viene usato anche da diverse applicazioni proprietarie integrate in Windows, ad esempio Microsoft Store.

Questo pacchetto è destinato a .NET Standard in modo che possa essere usato in qualsiasi piattaforma dell'app: WinUI 3, UWP, WinForms, macchine virtuali Windows, Xamarin, Uno e altro ancora e in qualsiasi runtime: .NET Native, .NET Core, .NET Framework o Mono. Funziona su tutti. La superficie DELL'API è identica in tutti i casi, rendendola perfetta per la creazione di librerie condivise.

Inoltre, MVVM Toolkit include anche un target .NET 6, usato per abilitare ulteriori ottimizzazioni interne quando viene eseguito su .NET 6. La superficie dell'API pubblica è identica in entrambi i casi, quindi NuGet risolverà sempre la versione migliore possibile del pacchetto senza doversi preoccupare delle API disponibili nella piattaforma.

Per iniziare

Per installare il pacchetto da Visual Studio:

1. In Esplora soluzioni, fare clic con il pulsante destro del mouse sul progetto e selezionare Gestisci pacchetti NuGet. Cerca CommunityToolkit.Mvvm e installalo.

   

2. Aggiungere una direttiva using o Imports per usare le nuove API:

   using CommunityToolkit.Mvvm;
   

   Imports CommunityToolkit.Mvvm
   

3. Gli esempi di codice sono disponibili nelle altre pagine della documentazione per MVVM Toolkit e negli unit test per il progetto.

Quando è consigliabile usare questo pacchetto?

Usare questo pacchetto per l'accesso a una raccolta di tipi leggeri standard e autonomi che forniscono un'implementazione iniziale per la creazione di app moderne usando il modello MVVM. Questi tipi sono in genere sufficienti per molti utenti per creare app senza bisogno di riferimenti esterni aggiuntivi.

I tipi inclusi sono:

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

Questo pacchetto mira a offrire la massima flessibilità possibile, in modo che gli sviluppatori siano liberi di scegliere quali componenti usare. Tutti i tipi sono ad accoppiamento libero, in modo che sia necessario includere solo ciò che si usa. Non è necessario adottare completamente una specifica serie di API onnicomprensive, né esiste un insieme di pattern obbligatori da seguire quando si sviluppano applicazioni usando questi strumenti di supporto. Combina questi blocchi nel modo più adatto alle tue esigenze.

Risorse aggiuntive

• Scopri l'app di esempio (per diversi framework dell'interfaccia utente) per vedere il MVVM Toolkit in azione.
• È anche possibile trovare altri esempi negli unit test.