設定 ASP.NET Core Blazor 的修剪器

  • 發行項

注意

這不是這篇文章的最新版本。 如需目前版本，請參閱本文的 .NET 8 版本。

重要

這些發行前產品的相關資訊在產品正式發行前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

如需目前版本，請參閱本文的 .NET 8 版本。

本文說明如何在建置 Blazor 應用程式時，控制中繼語言 (IL) 修剪器。

Blazor WebAssembly 會執行中繼語言 (IL) 修剪，以減少已發佈輸出的大小。 根據預設，發佈應用程式時會發生修剪。

針對已發佈應用程式修剪可能造成有害的影響。 在使用反映的應用程式中，IL 修剪器通常無法判斷執行階段反映所需的類型，並且一律修剪。 舉例來說，JS Interop 的複雜架構類型，例如 KeyValuePair，預設可能會修剪，而且無法在執行階段供 JS Interop 呼叫使用。 在這些情況下，建議您改為建立自己的自訂類型。 IL 修剪器也無法在執行階段對應用程式的動態行為做出反應。 為了確保已修剪的應用程式在部署後正常運作，請在開發時經常測試已發佈的輸出。

若要設定 IL 修剪器，請參閱 .NET 基本概念文件中的修剪選項一文，其中包含下列主題的指引：

  • 使用專案檔中的 <PublishTrimmed> 屬性，停用整個應用程式的修剪。
  • 控制 IL 修剪器積極捨棄未使用 IL 的方式。
  • 停止 IL 修剪器修剪特定組件。
  • 用於修剪的「根」組件。
  • 在專案檔中將 <SuppressTrimAnalysisWarnings> 屬性設定為 false，以針對反映的類型顯露警告。
  • 控制符號修剪和偵錯工具支援。
  • 設定 IL 修剪器功能以便修剪架構程式庫功能。

其他資源