Общие сведения о наборе средств MVVM

Пакет CommunityToolkit.Mvvm (aka MVVM Toolkit, прежнее название Microsoft.Toolkit.Mvvm) — это современная, быстрая и модульная библиотека MVVM. Он является частью набора средств сообщества .NET и построен на основе следующих принципов:

• Независимо от платформы и среды выполнения - .NET Standard 2.0, .NET Standard 2.1 и .NET 6🚀 (не привязано к фреймворку пользовательского интерфейса)
• Простое для получения и использования . Нет строгих требований к структуре приложений или парадигмам кодирования (за пределами MVVM), т. е. гибкого использования.
• À la carte - Свобода, чтобы выбрать, какие компоненты следует использовать.
• Эталонная реализация — компактная и производительная, предоставляет реализации интерфейсов, включённых в библиотеку базовых классов, но не имеющих конкретных типов для их непосредственного использования.

Набор средств MVVM поддерживается и публикуется корпорацией Майкрософт, а также входит в состав .NET Foundation. Он также используется несколькими сторонними приложениями, встроенными в Windows, такими как Microsoft Store.

Этот пакет предназначен для .NET Standard, поэтому его можно использовать на любой платформе приложений: WinUI 3, UWP, WinForms, WPF, Xamarin, Uno и многое другое; и в любой среде выполнения: .NET Native, .NET Core, платформа .NET Framework или Mono. Он работает на всех них. Поверхность API идентична во всех случаях, что делает ее идеальной для создания общих библиотек.

Кроме того, набор средств MVVM также имеет целевой объект .NET 6 , который используется для включения дополнительных внутренних оптимизаций при запуске в .NET 6. Публичная поверхность API идентична в обоих случаях, поэтому NuGet всегда будет выбирать наиболее подходящую версию пакета, и пользователям не придётся беспокоиться о том, какие API будут доступны на их платформе.

Начало работы

Чтобы установить пакет из Visual Studio, выполните указанные ниже действия.

1. В обозревателе решений щелкните правой кнопкой мыши проект и выберите Управление пакетами NuGet. Найдите CommunityToolkit.Mvvm и установите его.

   

2. Добавьте директиву using или Import для использования новых API:

   using CommunityToolkit.Mvvm;
   

   Imports CommunityToolkit.Mvvm
   

3. Примеры кода доступны на других страницах документации для набора средств MVVM и в модульных тестах для проекта.

Когда следует использовать этот пакет?

Используйте этот пакет для доступа к коллекции стандартных, автономных, упрощенных типов, которые предоставляют начальную реализацию для создания современных приложений с помощью шаблона MVVM. Эти типы обычно достаточно для многих пользователей для создания приложений без дополнительных внешних ссылок.

Включенные типы:

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

Этот пакет направлен на то, чтобы обеспечить максимальную гибкость, поэтому разработчики могут выбирать, какие компоненты следует использовать. Все типы слабо связаны, поэтому необходимо включить только то, что вы используете. Нет необходимости полностью переходить на определённую серию всеобъемлющих API, и также нет набора обязательных паттернов, которым нужно следовать при создании приложений с помощью этих вспомогательных средств. Объедините эти стандартные блоки таким образом, чтобы лучше всего соответствовать вашим потребностям.

Дополнительные ресурсы

• Ознакомьтесь с примером приложения (для нескольких платформ пользовательского интерфейса), чтобы просмотреть набор средств MVVM в действии.
• Дополнительные примеры можно найти в модульных тестах.