Pengantar paket Performa Tinggi

berisi pembantu CommunityToolkit.HighPerformance dan ekstensi untuk bekerja dalam skenario performa tinggi. Paket ini dapat diinstal melalui NuGet, dan memiliki multi-target berikut:

• .NET Standar 2.0
• .NET Standard 2.1+
• .NET 6
• .NET 7

Ini berarti Anda dapat menggunakannya dari apa pun mulai dari aplikasi UWP atau .NET Framework warisan, game yang ditulis dalam Unity, aplikasi seluler lintas platform menggunakan Xamarin, hingga pustaka .NET Standard dan aplikasi .NET 6 dan .NET 7 modern. Permukaan API hampir identik dalam semua kasus, dan banyak pekerjaan telah dimasukkan ke backporting sebanyak mungkin fitur ke target yang lebih lama seperti .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 (seperti .NET 7) jika memungkinkan, sambil tetap menawarkan sebagian besar fungsionalitasnya ke semua platform target.

Memulai

Untuk menginstal paket dari dalam Visual Studio:

1. Di Penjelajah Solusi, klik kanan 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 membuat penggunaan API yang berat 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!

Di mana untuk memulai?

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

• Span2D<T> dan Memory2D<T>, untuk Span<T> abstraksi dan Memory<T>-like melalui memori 2D
• MemoryOwner<T> dan SpanOwner<T>, jika Anda menggunakan System.Buffers.ArrayPool<T>.
• StringPool, untuk ArrayPool<T>jenis -like ke instans cache string
• ParallelHelper, jika Anda menggunakan System.Threading.Tasks.Parallel.

Sumber Daya Tambahan:

Anda dapat menemukan lebih banyak contoh dalam pengujian unit.