Pengantar Toolkit MVVM

Paket CommunityToolkit.Mvvm (alias MVVM Toolkit, sebelumnya bernama Microsoft.Toolkit.Mvvm) adalah pustaka MVVM modern, cepat, dan modular. Ini adalah bagian dari Toolkit Komunitas .NET dan dibangun di sekitar prinsip-prinsip berikut:

• Platform dan Runtime Independen - .NET Standard 2.0, .NET Standard 2.1 dan .NET 6🚀 (agnostik terhadap framework UI)
• Mudah diambil dan digunakan - Tidak ada persyaratan ketat pada Struktur aplikasi atau paradigma pengkodean (di luar 'MVVM'ness), yaitu, penggunaan yang fleksibel.
• À la carte - Kebebasan untuk memilih komponen mana yang akan digunakan.
• Implementasi Referensi - Ringkas dan efisien, menyediakan implementasi untuk antarmuka yang disertakan dalam Pustaka Kelas Dasar, tetapi tidak memiliki tipe konkret untuk digunakan secara langsung.

Toolkit MVVM dikelola dan diterbitkan oleh Microsoft, dan bagian dari .NET Foundation. Ini juga digunakan oleh beberapa aplikasi pihak pertama yang dibangun ke dalam Windows, seperti Microsoft Store.

Paket ini menargetkan .NET Standard sehingga dapat digunakan pada platform aplikasi apa pun: WinUI 3, UWP, WinForms, WPF, Xamarin, Uno, dan banyak lagi; dan pada runtime apa pun: .NET Native, .NET Core, .NET Framework, atau Mono. Ini berjalan pada mereka semua. Permukaan API identik dalam semua kasus, membuatnya sempurna untuk membangun pustaka bersama.

Selain itu, Toolkit MVVM juga memiliki target .NET 6 , yang digunakan untuk mengaktifkan lebih banyak pengoptimalan internal saat berjalan pada .NET 6. Permukaan API publik identik dalam kedua kasus, sehingga NuGet akan selalu menyelesaikan versi paket terbaik tanpa konsumen harus khawatir tentang API mana yang akan tersedia di platform mereka.

Memulai

Untuk menginstal paket dari dalam Visual Studio:

1. Di Penjelajah Solusi, klik kanan proyek dan pilih Kelola Paket NuGet. Cari CommunityToolkit.Mvvm dan instal.

   

2. Tambahkan direktif penggunaan atau Impor untuk menggunakan API baru:

   using CommunityToolkit.Mvvm;
   

   Imports CommunityToolkit.Mvvm
   

3. Contoh kode tersedia di halaman dokumentasi lainnya untuk MVVM Toolkit, dan di uji unit untuk proyek tersebut.

Kapan saya harus menggunakan paket ini?

Gunakan paket ini untuk akses ke kumpulan jenis standar, mandiri, ringan yang menyediakan implementasi awal untuk membangun aplikasi modern menggunakan pola MVVM. Jenis ini saja biasanya cukup bagi banyak pengguna untuk membangun aplikasi tanpa memerlukan referensi eksternal tambahan.

Jenis yang disertakan adalah:

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

Paket ini bertujuan untuk menawarkan fleksibilitas sebanyak mungkin, sehingga pengembang bebas memilih komponen mana yang akan digunakan. Semua tipe berketerkaitan longgar, sehingga Anda hanya perlu menyertakan yang Anda gunakan. Tidak ada persyaratan untuk "all-in" dengan serangkaian API khusus yang mencakup semua, juga tidak ada serangkaian pola wajib yang perlu diikuti saat membangun aplikasi menggunakan pembantu ini. Gabungkan blok penyusun ini dengan cara yang paling sesuai dengan kebutuhan Anda.

Sumber Daya Tambahan:

• Lihat contoh aplikasi (untuk beberapa kerangka kerja UI) untuk melihat Toolkit MVVM beraksi.
• Anda juga dapat menemukan lebih banyak contoh dalam uji unit.