Ú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:

• Platforma a modul runtime Independent.NET - Standard 2.0, .NET Standard 2.1 a .NET 6🚀 (nezávislá na rozhraní UI Framework)
• 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 – Štíhlá a výkonná, poskytuje implementace pro rozhraní, která jsou zahrnuta v knihovně základních tříd, ale nemají konkrétní typy, které je použít přímo.

Sada MVVM Toolkit je udržována a publikována společností Microsoft a součástí platformy .NET Foundation. Používá se také několika aplikacemi první strany, které jsou integrované do Windows, jako je Například Microsoft Store.

Tento balíček cílí na .NET Standard , aby ho bylo možné použít na libovolné platformě aplikací: UPW, WinForms, WPF, Xamarin, Uno a další a v jakémkoli modulu runtime: .NET Native, .NET Core, .NET Framework nebo Mono. Běží na všech z nich. 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íl .NET 6 , který se používá k povolení více interních optimalizací při spuštění v .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ík řešení klikněte pravým tlačítkem 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 rutin není nutné přejít na "vše" s konkrétní řadou všech rozhraní API, ani neexistuje sada povinných vzorů, které je potřeba dodržovat při vytváření aplikací pomocí těchto pomocných rutin. 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 testech jednotek.