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 Independent.NET - Standard 2.0, .NET Standard 2.1 dan .NET 6🚀 (UI Framework Agnostic)
• 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 - Ramping dan berkinerja, menyediakan implementasi untuk antarmuka yang termasuk dalam Pustaka Kelas Dasar, tetapi tidak memiliki jenis konkret untuk menggunakannya 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: 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. Sampel kode tersedia di halaman dokumen lain untuk Toolkit MVVM, dan dalam pengujian unit untuk proyek.

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 jenis digabungkan secara longgar, sehingga hanya perlu menyertakan apa 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 pengujian unit.