Partager via

Configurez l’outil de découpage (Trimmer) pour ASP.NET Core Blazor

  • Article

Remarque

Ceci n’est pas la dernière version de cet article. Pour la version actuelle, consultez la version .NET 9 de cet article.

Avertissement

Cette version d’ASP.NET Core n’est plus prise en charge. Pour plus d’informations, consultez la stratégie de support .NET et .NET Core. Pour la version actuelle, consultez la version .NET 9 de cet article.

Important

Ces informations portent sur la préversion du produit, qui est susceptible d’être en grande partie modifié avant sa commercialisation. Microsoft n’offre aucune garantie, expresse ou implicite, concernant les informations fournies ici.

Pour la version actuelle, consultez la version .NET 9 de cet article.

Cet article explique comment contrôler l’outil de découpage (Trimmer) de langage intermédiaire (IL) pendant la génération d’une application Blazor.

Blazor WebAssembly effectue le découpage du langage intermédiaire (IL) pour réduire la taille de la sortie publiée. La réduction se produit lors de la publication d’une application.

Le découpage peut avoir des effets néfastes pour l’application publiée. Dans les applications qui utilisent la réflexion, l’outil de découpage IL est souvent incapable de déterminer les types nécessaires à la réflexion au moment de l’exécution, et de les découper. Ainsi, les types d’infrastructures complexes pour l’interopérabilité JS, par exemple KeyValuePair, peuvent être réduits et ne pas être disponibles au moment de l’exécution pour les appels d’interopérabilité JS. Dans ce genre de situation, nous vous recommandons de créer vos propres types personnalisés à la place. L’outil de découpage IL n’est pas non plus capable de réagir au comportement dynamique d’une application au moment de l’exécution. Pour vous assurer que l’application découpée fonctionne correctement une fois déployée, testez fréquemment la sortie publiée lors du développement.

Configuration

Pour configurer l’outil de découpage IL, consultez l’article Options de découpage dans la documentation relative aux notions de base de .NET, qui comprend des conseils d’aide sur les sujets suivants :

  • Désactivez le découpage pour l’ensemble de l’application avec la propriété <PublishTrimmed> dans le Fichier projet.
  • Contrôler l’intensité avec laquelle l’outil de découpage IL doit abandonner l’IL inutilisé.
  • Empêcher l’outil de découpage IL de découper des assemblys spécifiques.
  • Assemblys « racine » pour le découpage.
  • Les avertissements de surface pour les types réfléchis en définissant la propriété <SuppressTrimAnalysisWarnings> sur false dans le Fichier projet.
  • Contrôlez le découpage des symboles et la prise en charge du débogueur.
  • Définir des fonctionnalités d’outil de découpage IL pour le découpage des fonctionnalités de bibliothèque d’infrastructure.

Granularité de découpage par défaut

La granularité de découpage par défaut pour les applications Blazor est partial. Pour découper tous les assemblys, remplacez la granularité par full dans le fichier projet de l’application :

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

Pour plus d’informations, consultez la section Options de découpage (documentation .NET).

Ressources supplémentaires