Pré-requisitos para o código de portabilidade

Faça as alterações necessárias para criar e executar um aplicativo .NET antes de iniciar o trabalho para portar seu código. Essas alterações podem ser feitas durante a criação e a execução de um aplicativo .NET Framework.

Importante

O Assistente de Atualização do .NET foi oficialmente preterido. Use 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 posterior. 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 build, para que você possa se modernizar mais rapidamente com menos esforço manual.

Atualizar para ferramentas necessárias

Atualize para uma versão do MSBuild/Visual Studio que dê suporte à versão do .NET que você terá como destino. Consulte a relação de controle de versão entre o SDK do .NET, o MSBuild e o 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 dá 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 do Target Framework , selecione .NET Framework 4.7.2.
  3. Recompile o projeto.

Como seus projetos agora têm como destino o .NET Framework 4.7.2, use essa versão do .NET Framework como base para portabilidade de código.

Alterar para formato PackageReference

Converta todas as referências no formato PackageReference .

Converter para o formato de projeto estilo do SDK

Converta seus projetos no formato estilo SDK.

Atualizar dependências

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

Próximas etapas

  • Last updated on