高效能套件簡介

CommunityToolkit.HighPerformance包含協助程式和擴充功能，以在高效能案例中運作。 此套件可以透過 NuGet 安裝，而且其具有下列多重目標：

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

這表示您可以使用它，從UWP或舊版 .NET Framework 應用程式、以 Unity 撰寫的遊戲、使用 Xamarin 的跨平臺行動應用程式，到 .NET Standard 連結庫和新式 .NET 6 和 .NET 7 應用程式。 在所有情況下，API 介面幾乎完全相同，而且許多工作都已投入到盡可能多的回送至舊版目標，例如 .NET Standard 2.0。 除了一些次要差異之外，您可以預期所有目標架構都有相同的 API 可供使用。 使用多重目標的原因是允許套件盡可能利用新式運行時間上的所有最新 API（例如 .NET 7），同時仍為所有目標平臺提供大部分功能。

開始使用

若要從 Visual Studio 內安裝套件：

1. 在 方案總管 中，以滑鼠右鍵按兩下專案，然後選取 [管理 NuGet 套件]。 搜尋 CommunityToolkit.HighPerformance 並加以安裝。

   

2. 新增 using 或 Imports 指示詞以使用新的 API：

   using CommunityToolkit.HighPerformance;
   

   Imports CommunityToolkit.HighPerformance
   

3. 程式代碼範例可在MVVM工具組的其他文件頁面，以及專案的單元測試中取得。

我何時應該使用此套件？

如其名所示，高效能套件包含一組著重於優化的 API。 所有新的 API 都經過精心設計，以便在使用它們時達到最佳效能，無論是透過降低記憶體配置、元件層級的微優化，還是以有助於一般撰寫效能導向程式代碼的方式建構 API。

此套件會大量使用 API，例如：

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

如果您已經熟悉這些 API，或即使您剛開始使用以 C# 撰寫高效能程式代碼，而且想要在您自己的專案中使用一組經過良好測試的協助程式，請查看此套件中包含的內容，以查看如何在您自己的專案中使用它！

哪裡可以開始？

以下是一些您可以先查看的 API，如果您已經使用上述其中一種類型：

• Span2D<T> 和 Memory2D<T>，適用於 Span<T> 和 Memory<T>-like 抽象概念超過 2D 記憶體
• MemoryOwner<T> 如果您使用 SpanOwner<T>，則為 System.Buffers.ArrayPool<T>。
• StringPool，用於 ArrayPool<T>快取 string 實例的類似型別
• ParallelHelper如果您使用的是 ，則為 System.Threading.Tasks.Parallel。

其他資源

您可以在單元測試中找到更多範例。