Introducción al kit de herramientas MVVM

El paquete CommunityToolkit.Mvvm (también conocido como kit de herramientas MVVM anteriormente denominado Microsoft.Toolkit.Mvvm) es una biblioteca MVVM moderna, rápida y modular. Forma parte del kit de herramientas de la comunidad de .NET y se basa en los siguientes principios:

• Plataforma y Runtime independiente - .NET Standard 2.0, .NET Standard 2.1 and .NET 6🚀 (UI Framework independiente)
• Recogida y uso sencillos : no hay requisitos estrictos en la estructura de aplicaciones o los paradigmas de codificación (excepto "MVVM", es decir, uso flexible).
• A la carta: libertad para elegir qué componentes usar.
• Implementación de referencia: Lean y eficaz, proporciona implementaciones para interfaces incluidas en la biblioteca de clases base pero que carecen de tipos concretos para usarlas directamente.

Microsoft mantiene y publica el kit de herramientas MVVM y forma parte de .NET Foundation. También lo usan varias aplicaciones de primera entidad integradas en Windows, como Microsoft Store.

Este paquete tiene como destino .NET Standard para que se pueda usar en cualquier plataforma de aplicaciones: WinUI 3, UWP, WinForms, WPF, Xamarin, Uno, etc. y en cualquier entorno de ejecución: .NET Native, .NET Core, .NET Framework o Mono. Se ejecuta en todos ellos. La superficie de la API es idéntica en todos los casos, lo que hace que sea perfecta para crear bibliotecas compartidas.

Además, el kit de herramientas de MVVM también tiene un destino .NET 6 que se usa para habilitar optimizaciones más internas al ejecutarse en .NET 6. La superficie de la API pública es idéntica en ambos casos, por lo que NuGet siempre resolverá la mejor versión posible del paquete sin que los consumidores tengan que preocuparse de qué API estarán disponibles en su plataforma.

Introducción

Para instalar el paquete desde Visual Studio:

1. En el Explorador de soluciones, haga clic con el botón derecho en el proyecto y seleccione Administrar paquetes NuGet. Busque CommunityToolkit.Mvvm e instálelo.

   

2. Agregue una directiva using o Imports para utilizar las nuevas API:

   using CommunityToolkit.Mvvm;
   

   Imports CommunityToolkit.Mvvm
   

3. Los ejemplos de código están disponibles en las otras páginas de documentos del kit de herramientas de MVVM y en las pruebas unitarias del proyecto.

¿Cuándo debería usar este paquete?

Use este paquete para acceder a una colección de tipos estándar, independientes y ligeros que proporcionan una implementación inicial para compilar aplicaciones modernas mediante el patrón MVVM. Estos tipos por sí solos suelen ser suficiente para que muchos usuarios compilen aplicaciones sin necesidad de referencias externas adicionales.

Los tipos incluidos son los siguientes:

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

Este paquete tiene como objetivo ofrecer toda la flexibilidad posible para que los desarrolladores pueden elegir qué componentes usar. Todos los tipos se acoplan de forma flexible, por lo que solo es necesario incluir lo que se usen. No hay ningún requisito para tener que comprometerse con una serie específica de API que abarque todo, ni existe un conjunto de patrones obligatorios que deban seguirse al compilar aplicaciones con estos asistentes. Combine estos bloques de creación de la manera que mejor se adapte a sus necesidades.

Recursos adicionales

• Consulte la aplicación de ejemplo (para varios marcos de interfaz de usuario) para ver el kit de herramientas de MVVM en acción.
• También puede encontrar más ejemplos en las pruebas unitarias.