Wprowadzenie do zestawu narzędzi MVVM Toolkit

Pakiet CommunityToolkit.Mvvm (aka MVVM Toolkit, wcześniej nazwany Microsoft.Toolkit.Mvvm) to nowoczesna, szybka i modularna biblioteka MVVM. Jest ona częścią zestawu narzędzi .NET Community Toolkit i jest oparta na następujących zasadach:

• Platforma i środowisko uruchomieniowe Independent.NET - Standard 2.0, .NET Standard 2.1 i .NET 6🚀 (UI Framework Agnostic)
• Proste w odbiorze i użyciu — nie ma rygorystycznych wymagań dotyczących struktury aplikacji lub paradygmatów kodowania (poza "MVVM"ness), tj. elastycznego użycia.
• À la carte - Swoboda wyboru, które składniki mają być używane.
• Implementacja referencyjna — chuda i wydajna, zapewniając implementacje interfejsów, które znajdują się w bibliotece klas bazowych, ale nie mają konkretnych typów, aby ich używać bezpośrednio.

Zestaw narzędzi MVVM Toolkit jest obsługiwany i publikowany przez firmę Microsoft oraz część programu .NET Foundation. Jest on również używany przez kilka aplikacji innych firm, które są wbudowane w system Windows, takich jak Microsoft Store.

Ten pakiet jest przeznaczony dla platformy .NET Standard , aby można go było używać na dowolnej platformie aplikacji: uwP, WinForms, WPF, Xamarin, Uno i innych środowiskach uruchomieniowych: .NET Native, .NET Core, .NET Framework lub Mono. Jest on uruchamiany na wszystkich z nich. Powierzchnia interfejsu API jest identyczna we wszystkich przypadkach, dzięki czemu doskonale nadaje się do tworzenia bibliotek udostępnionych.

Ponadto zestaw narzędzi MVVM Toolkit ma również docelową platformę .NET 6 , która służy do włączania większej liczby optymalizacji wewnętrznych podczas uruchamiania na platformie .NET 6. Publiczna powierzchnia interfejsu API jest identyczna w obu przypadkach, więc pakiet NuGet zawsze rozpozna najlepszą możliwą wersję pakietu bez konieczności martwienia się o to, które interfejsy API będą dostępne na ich platformie.

Wprowadzenie

Aby zainstalować pakiet z poziomu programu Visual Studio:

1. W Eksplorator rozwiązań kliknij prawym przyciskiem myszy projekt i wybierz polecenie Zarządzaj pakietami NuGet. Wyszukaj ciąg CommunityToolkit.Mvvm i zainstaluj go.

   

2. Dodaj dyrektywę using lub Import, aby użyć nowych interfejsów API:

   using CommunityToolkit.Mvvm;
   

   Imports CommunityToolkit.Mvvm
   

3. Przykłady kodu są dostępne na innych stronach dokumentacji dla zestawu narzędzi MVVM Toolkit oraz w testach jednostkowych dla projektu.

Kiedy należy używać tego pakietu?

Ten pakiet służy do uzyskiwania dostępu do kolekcji standardowych, samodzielnych, lekkich typów, które zapewniają początkową implementację tworzenia nowoczesnych aplikacji przy użyciu wzorca MVVM. Te typy są zwykle wystarczające dla wielu użytkowników do tworzenia aplikacji bez konieczności dodatkowych odwołań zewnętrznych.

Uwzględnione typy to:

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

Ten pakiet ma na celu zapewnienie jak największej elastyczności, dlatego deweloperzy mogą swobodnie wybierać składniki do użycia. Wszystkie typy są luźno powiązane, więc konieczne jest tylko uwzględnienie używanych elementów. Nie ma potrzeby przechodzenia do "all-in" z określoną serią wszystkich obejmujących interfejsów API, ani nie istnieje zestaw obowiązkowych wzorców, które należy przestrzegać podczas kompilowania aplikacji przy użyciu tych pomocników. Połącz te bloki konstrukcyjne w sposób, który najlepiej odpowiada Twoim potrzebom.

Dodatkowe zasoby

• Zapoznaj się z przykładową aplikacją (dla wielu struktur interfejsu użytkownika), aby zobaczyć, jak działa zestaw narzędzi MVVM Toolkit.
• Więcej przykładów można również znaleźć w testach jednostkowych.