Pengantar paket Performa Tinggi

Paket 📦 CommunityToolkit.HighPerformance berisi pembantu dan ekstensi untuk bekerja dalam skenario berperforma tinggi. Paket ini dapat diinstal melalui NuGet, dan memiliki multitarget berikut:

• .NET Standar 2.0
• .NET 7

Ini berarti Anda dapat menggunakannya untuk apa pun mulai dari aplikasi UWP atau .NET Framework warisan, game yang ditulis di Unity, aplikasi seluler lintas platform menggunakan Xamarin, hingga pustaka .NET Standard dan aplikasi modern .NET 7 dan yang lebih baru. Permukaan API hampir identik dalam semua kasus, dan upaya yang signifikan telah dilakukan untuk melakukan backporting sebanyak mungkin fitur ke target yang lebih lama, seperti misalnya .NET Standard 2.0. Kecuali untuk beberapa perbedaan kecil, Anda dapat mengharapkan API yang sama tersedia di semua kerangka kerja target. Alasan mengapa multi-penargetan telah digunakan adalah untuk memungkinkan paket memanfaatkan semua API terbaru pada runtime modern jika memungkinkan, sambil tetap menawarkan sebagian besar fungsionalitasnya ke semua platform target.

Get started

Untuk menginstal paket dari dalam Visual Studio:

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

   

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

   using CommunityToolkit.HighPerformance;
   

   Imports CommunityToolkit.HighPerformance
   

3. Sampel kode tersedia di halaman dokumen lain untuk Toolkit MVVM, dan dalam pengujian unit untuk proyek.

Kapan saya harus menggunakan paket ini?

Seperti namanya, paket Performa Tinggi berisi sekumpulan API yang sangat berfokus pada pengoptimalan. Semua API baru telah dibuat dengan hati-hati untuk mencapai performa terbaik saat menggunakannya, baik melalui pengurangan alokasi memori, pengoptimalan mikro pada tingkat perakitan, atau dengan menyusun API dengan cara yang memfasilitasi penulisan kode berorientasi performa secara umum.

Paket ini banyak menggunakan API seperti:

• System.Span<T>
• System.Memory<T>
• System.Buffers.ArrayPool<T>
• System.Runtime.CompilerServices.Unsafe
• System.Runtime.InteropServices.MemoryMarshal
• System.Threading.Tasks.Parallel

Jika Anda sudah terbiasa dengan API ini atau bahkan jika Anda baru saja mulai menulis kode performa tinggi di C# dan ingin sekumpulan pembantu yang diuji dengan baik untuk digunakan dalam proyek Anda sendiri, lihat apa yang disertakan dalam paket ini untuk melihat bagaimana Anda dapat menggunakannya dalam proyek Anda sendiri!

Mulai dari mana?

Berikut adalah beberapa API yang dapat Anda lihat terlebih dahulu, jika Anda sudah menggunakan salah satu jenis yang disebutkan sebelumnya:

• Span2D<T> dan Memory2D<T>, untuk abstraksi mirip Span<T> di atas memori 2D
• MemoryOwner<T> dan SpanOwner<T>, jika Anda menggunakan System.Buffers.ArrayPool<T>.
• StringPool, untuk tipe seperti ArrayPool<T> untuk menyimpan instans string dalam cache
• ParallelHelper, jika Anda menggunakan System.Threading.Tasks.Parallel.

Sumber daya tambahan

Anda dapat menemukan lebih banyak contoh dalam pengujian unit.