Configurar o Filtro para ASP.NET Core Blazor

  • Artigo

Observação

Esta não é a versão mais recente deste artigo. Para informações sobre a versão vigente, confira a Versão do .NET 8 deste artigo.

Importante

Essas informações relacionam-se ao produto de pré-lançamento, que poderá ser substancialmente modificado antes do lançamento comercial. A Microsoft não oferece nenhuma garantia, explícita ou implícita, quanto às informações fornecidas aqui.

Para informações sobre a versão vigente, confira a Versão do .NET 8 deste artigo.

Este artigo explica como controlar o Filtro de Linguagem Intermediária (IL) ao criar um aplicativo Blazor.

O Blazor WebAssembly executa o corte do IL (linguagem intermediária) para reduzir o tamanho da saída publicada. Por padrão, o corte ocorre ao publicar um aplicativo.

O corte pode ter efeitos prejudiciais para o aplicativo publicado. Nos aplicativos que usam a reflexão, o IL Trimmer geralmente não pode determinar os tipos necessários para a reflexão em runtime e os cortam assim mesmo. Por exemplo, tipos de estrutura complexos para interoperabilidade com o JS, como o KeyValuePair, podem ser cortados por padrão e não estar disponíveis em runtime para chamadas de interoperabilidade com o JS. Nesses casos, recomendamos criar tipos personalizados próprios. O IL Trimmer também não consegue reagir ao comportamento dinâmico de um aplicativo em runtime. Para garantir que o aplicativo cortado funcione corretamente depois de implantado, teste a saída publicada com frequência durante o desenvolvimento.

Para configurar o IL Trimmer, confira o artigo Opções de corte na documentação de Conceitos básicos do .NET, que inclui diretrizes sobre os seguintes assuntos:

  • Desabilitar o corte do aplicativo inteiro com a propriedade <PublishTrimmed> no arquivo de projeto.
  • Controlar o nível de agressividade do descarte da IL não utilizada pelo IL Trimmer.
  • Impedir que o IL Trimmer corte assemblies específicos.
  • Assemblies "raiz" para corte.
  • Avisos do Surface para tipos refletidos ao definir a propriedade <SuppressTrimAnalysisWarnings> como false no arquivo de projeto.
  • Controlar o corte de símbolos e o suporte ao depurador.
  • Definir os recursos do IL Trimmer para cortar recursos da biblioteca de estruturas.

Recursos adicionais