Freigeben über

Konfigurieren des Trimmers für ASP.NET Core Blazor

  • Artikel

Hinweis

Dies ist nicht die neueste Version dieses Artikels. Die aktuelle Version finden Sie in der .NET 9-Version dieses Artikels.

Warnung

Diese Version von ASP.NET Core wird nicht mehr unterstützt. Weitere Informationen finden Sie in der Supportrichtlinie für .NET und .NET Core. Informationen zum aktuellen Release finden Sie in der .NET 8-Version dieses Artikels.

Wichtig

Diese Informationen beziehen sich auf ein Vorabversionsprodukt, das vor der kommerziellen Freigabe möglicherweise noch wesentlichen Änderungen unterliegt. Microsoft gibt keine Garantie, weder ausdrücklich noch impliziert, hinsichtlich der hier bereitgestellten Informationen.

Die aktuelle Version finden Sie in der .NET 9-Version dieses Artikels.

In diesem Artikel wird erläutert, wie Sie den IL-Trimmer (Intermediate Language, Zwischensprache) beim Erstellen einer Blazor-App steuern.

Blazor WebAssembly führt eine IL-Kürzung (Intermediate Language, Zwischensprache) aus, um die Größe der veröffentlichten Ausgabe zu verringern. Das Abschneiden erfolgt bei der Veröffentlichung einer App.

Das Kürzen kann nachteilige Auswirkungen auf die veröffentlichte App haben. In Apps, die Reflexion verwenden, kann der IL-Trimmer oft nicht die erforderlichen Typen für die Laufzeitreflexion bestimmen und kürzen. So können beispielsweise komplexe Framework-Typen für JS-Interoperabilität, wie KeyValuePair, abgeschnitten werden und zur Laufzeit für JS-Interop-Aufrufe nicht verfügbar sein. In diesen Fällen wird empfohlen, stattdessen eigene benutzerdefinierte Typen zu erstellen. Der IL-Trimmer kann auch nicht auf das dynamische Verhalten einer App zur Laufzeit reagieren. Wenn Sie sicherstellen möchten, dass die gekürzte App nach der Bereitstellung ordnungsgemäß funktioniert, testen Sie während der Entwicklung regelmäßig die veröffentlichte Ausgabe.

Konfiguration

Informationen zum Konfigurieren des IL-Trimmers finden Sie im Artikel Kürzungsoptionen in der Dokumentation zu .NET-Grundlagen, die zudem Leitlinien zu folgenden Themen enthält:

  • Deaktivieren der Kürzung für die gesamte App mit der Eigenschaft <PublishTrimmed> in der Projektdatei
  • Steuern, wie aggressiv nicht verwendete IL vom IL-Trimmer verworfen wird
  • Verhindern, dass der IL-Trimmer bestimmte Assemblys kürzt
  • „Root“-Assemblys (Stammassemblys) für die Kürzung
  • Oberflächenwarnungen für reflektierte Typen, indem die <SuppressTrimAnalysisWarnings>-Eigenschaft in der Projektdatei auf false festgelegt wird.
  • Steuern der Symbolkürzung und Debuggerunterstützung
  • Festlegen von IL-Trimmerfeatures für Bibliotheksfeatures des Trimmingframeworks

Standardmäßige Granularität des Trimmers

Die Standardmäßige Trimmer-Granularität für Blazor Apps ist partial. Um alle Assemblys zu kürzen, ändern Sie die Granularität full in die Projektdatei der App:

<ItemGroup>
  <TrimMode>full</TrimMode>
</ItemGroup>

Weitere Informationen finden Sie in der Trimming-Optionen (.NET-Dokumentation).

Zusätzliche Ressourcen