Úvod do MVVM Toolkit

Balíček CommunityToolkit.Mvvm (neboli MVVM Toolkit, dříve pojmenovaný Microsoft.Toolkit.Mvvm) je moderní, rychlá a modulární knihovna MVVM. Je součástí sady nástrojů .NET Community Toolkit a je postavená na následujících principech:

• Nezávislé na platformě a runtime - .NET Standard 2.0, .NET Standard 2.1 a .NET 6🚀 (nezávislé na UI frameworku)
• Jednoduché vyzvednutí a použití – bez striktních požadavků na strukturu aplikací nebo paradigmata kódování (mimo "MVVM"ness), tj. flexibilní použití.
• À la carte - Svoboda zvolit, které součásti se mají použít.
• Referenční implementace – odlehčená a výkonná, poskytuje implementace rozhraní, která jsou součástí knihovny základních tříd, ale postrádají konkrétní typy pro jejich přímé použití.

Sada MVVM Toolkit je udržována a publikována společností Microsoft a součástí platformy .NET Foundation. Používá ho také několik aplikací od Microsoftu, které jsou součástí Windows, například Microsoft Store.

Tento balíček cílí na .NET Standard , aby ho bylo možné použít na libovolné platformě aplikací: WinUI 3, UPW, WinForms, WPF (Windows Presentation Foundation), Xamarin, Uno a další a v jakémkoli modulu runtime: .NET Native, .NET Core, .NET Framework nebo Mono. Funguje na všech. Povrch rozhraní API je ve všech případech stejný, takže je ideální pro vytváření sdílených knihoven.

Kromě toho má sada nástrojů MVVM také cílovou verzi .NET 6, která se používá k umožnění dalších interních optimalizací při běhu na platformě .NET 6. Veřejná plocha rozhraní API je v obou případech shodná, takže NuGet vždy vyřeší nejlepší možnou verzi balíčku, aniž by se uživatelé museli starat o to, která rozhraní API budou dostupná na své platformě.

Začínáme

Instalace balíčku ze sady Visual Studio:

1. V Průzkumníku řešení klikněte pravým tlačítkem myši na projekt a vyberte Spravovat balíčky NuGet. Vyhledejte CommunityToolkit.Mvvm a nainstalujte ho.

   

2. Přidejte direktivu using nebo Imports pro použití nových rozhraní API:

   using CommunityToolkit.Mvvm;
   

   Imports CommunityToolkit.Mvvm
   

3. Ukázky kódu jsou k dispozici na dalších stránkách dokumentace pro MVVM Toolkit a v testech jednotek projektu.

Kdy mám tento balíček použít?

Tento balíček použijte pro přístup k kolekci standardních, samostatných jednoduchých typů, které poskytují počáteční implementaci pro vytváření moderních aplikací pomocí vzoru MVVM. Tyto typy jsou obvykle dostatečné pro mnoho uživatelů k vytváření aplikací bez nutnosti dalších externích odkazů.

Zahrnuté typy jsou:

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

Cílem tohoto balíčku je nabídnout co největší flexibilitu, aby si vývojáři mohli vybrat, které komponenty se mají použít. Všechny typy jsou volně svázané, takže je nutné zahrnout pouze to, co používáte. Při vytváření aplikací pomocí těchto pomocných nástrojů není nutné plně se vázat na konkrétní sadu komplexních rozhraní API ani dodržovat pevně danou sadu povinných vzorů. Zkombinujte tyto stavební bloky způsobem, který nejlépe vyhovuje vašim potřebám.

Další materiály

• Podívejte se na ukázkovou aplikaci (pro více architektur uživatelského rozhraní) a podívejte se na sadu nástrojů MVVM v akci.
• Další příklady najdete také v jednotkových testech.