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

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

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

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

Этот пакет предназначен для .NET Standard, поэтому его можно использовать на любой платформе приложений: 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". Выполните поиск сообщества набор средств. Mvvm и установите его.

   

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

   using CommunityToolkit.Mvvm;
   

   Imports CommunityToolkit.Mvvm
   

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

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

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

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

• Сообщество набор средств. Mvvm.ComponentModel
  • ObservableObject
  • ObservableRecipient
  • ObservableValidator
• Сообщество набор средств. Mvvm.DependencyInjection
  • Ioc
• Сообщество набор средств. Mvvm.Input
  • RelayCommand
  • RelayCommand<T>
  • AsyncRelayCommand
  • AsyncRelayCommand<T>
  • IRelayCommand
  • IRelayCommand<T>
  • IAsyncRelayCommand
  • IAsyncRelayCommand<T>
• Сообщество набор средств. Mvvm.Messaging
  • IMessenger
  • WeakReferenceMessenger
  • StrongReferenceMessenger
  • IRecipient<TMessage>
  • MessageHandler<TRecipient, TMessage>
• Сообщество набор средств. Mvvm.Messaging.Messages
  • PropertyChangedMessage<T>
  • RequestMessage<T>
  • AsyncRequestMessage<T>
  • CollectionRequestMessage<T>
  • AsyncCollectionRequestMessage<T>
  • ValueChangedMessage<T>

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

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

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