Introduzione al pacchetto a prestazioni elevate

CommunityToolkit.HighPerformance Contiene helper ed estensioni per funzionare in scenari a prestazioni elevate. Questo pacchetto può essere installato tramite NuGet e ha le destinazioni seguenti:

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

Ciò significa che è possibile usarlo da qualsiasi applicazione UWP o .NET Framework legacy, giochi scritti in Unity, applicazioni per dispositivi mobili multipiattaforma usando Xamarin, alle librerie .NET Standard e alle moderne applicazioni .NET 6 e .NET 7. La superficie dell'API è quasi identica in tutti i casi e molte operazioni sono state inserite nel backporting del maggior numero possibile di funzionalità per destinazioni meno recenti come .NET Standard 2.0. Ad eccezione di alcune piccole differenze, è possibile prevedere che le stesse API siano disponibili in tutti i framework di destinazione. Il motivo per cui è stato usato multitargeting è consentire al pacchetto di sfruttare tutte le API più recenti nei runtime moderni (ad esempio .NET 7) quando possibile, pur offrendo la maggior parte delle sue funzionalità a tutte le piattaforme di destinazione.

Introduzione

Per installare il pacchetto da Visual Studio:

1. In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto e scegliere Gestisci pacchetti NuGet. Cercare CommunityToolkit.HighPerformance e installarlo.

   

2. Aggiungere una direttiva using o Imports per usare le nuove API:

   using CommunityToolkit.HighPerformance;
   

   Imports CommunityToolkit.HighPerformance
   

3. Gli esempi di codice sono disponibili nelle altre pagine della documentazione per MVVM Toolkit e negli unit test per il progetto.

Quando è consigliabile usare questo pacchetto?

Come suggerisce il nome, il pacchetto a prestazioni elevate contiene un set di API incentrate sull'ottimizzazione. Tutte le nuove API sono state create attentamente per ottenere le migliori prestazioni possibili quando vengono usati, tramite un'allocazione di memoria ridotta, micro ottimizzazioni a livello di assembly o strutturando le API in modo da facilitare la scrittura di codice orientato alle prestazioni in generale.

Questo pacchetto usa pesantemente le API, ad esempio:

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

Se si ha già familiarità con queste API o anche se si è appena iniziato a scrivere codice ad alte prestazioni in C# e si vuole usare un set di helper ben testati da usare nei propri progetti, vedere cosa è incluso in questo pacchetto per vedere come usarlo nei propri progetti.

Da dove iniziare?

Ecco alcune API che è possibile esaminare prima, se si usa già uno di questi tipi menzionati in precedenza:

• Span2D<T> e Memory2D<T>, per un'astrazione Span<T> e Memory<T>-like sulla memoria 2D
• MemoryOwner<T> e SpanOwner<T>, se si usa System.Buffers.ArrayPool<T>.
• StringPool, per un ArrayPool<T>tipo simile alle istanze della cache string
• ParallelHelper, se si usa System.Threading.Tasks.Parallel.

Risorse aggiuntive

Altri esempi sono disponibili negli unit test.