Pré-requisitos para portabilidade de código

Faça as alterações necessárias para criar e executar um aplicativo .NET antes de iniciar o trabalho de portabilidade do código. Essas alterações podem ser feitas enquanto ainda cria e executa um aplicativo .NET Framework.

Importante

O .NET Upgrade Assistant foi oficialmente preterido. Em vez disso, utilize o agente de chat de modernização do GitHub Copilot, que está incluído no Visual Studio 2026 e no Visual Studio 2022 17.14.16 ou versões posteriores. Esse agente analisa seus projetos e dependências, produz um plano de migração passo a passo com recomendações direcionadas e correções de código automatizadas e confirma cada alteração para que você possa validar ou reverter. Ele automatiza tarefas comuns de portabilidade — atualizando arquivos de projeto, substituindo APIs preteridas e resolvendo problemas de compilação — para que você possa se modernizar mais rapidamente com menos esforço manual.

Atualize para as ferramentas obrigatórias

Atualize para uma versão do MSBuild/Visual Studio que seja compatível com a versão do .NET que pretende utilizar. Consulte Relação de controle de versão entre o SDK do .NET, MSBuild e VS para obter mais informações.

Atualizar a versão de destino do .NET Framework

Recomendamos que você direcione seu aplicativo .NET Framework para a versão 4.7.2 ou superior. Isso garante a disponibilidade das alternativas de API mais recentes para casos em que o .NET Standard não oferece suporte a APIs existentes.

Para cada um dos projetos que você deseja portar, faça o seguinte no Visual Studio:

  1. Clique com o botão direito do mouse no projeto e selecione Propriedades.
  2. Na lista suspensa Target Framework , selecione .NET Framework 4.7.2.
  3. Recompile o projeto.

Como seus projetos agora visam o .NET Framework 4.7.2, use essa versão do .NET Framework como sua base para portar código.

Alterar para o formato PackageReference

Converta todas as referências para o formato PackageReference .

Converter para o formato de projeto estilo SDK

Converta seus projetos para o formato estilo SDK.

Atualizar dependências

Atualize as dependências para a versão mais recente disponível e para a versão .NET Standard sempre que possível.

Próximos passos

  • Last updated on