Partilhar via

O que é o .NET Upgrade Assistant?

O Assistente de Atualização do .NET ajuda a atualizar projetos para versões mais recentes do .NET e analisa seu código para detetar e corrigir possíveis incompatibilidades. Um foco da ferramenta é ajudar a atualizar um projeto do .NET Framework, .NET Core ou .NET, para a versão mais recente do .NET. Você usa a extensão ou ferramenta para atualizar projetos .NET inteiros, ou algum aspeto do projeto, como atualizar um arquivo de configuração de um tipo mais antigo para um tipo mais recente.

O Assistente de Atualização do .NET é distribuído como uma extensão do Visual Studio ou uma ferramenta de interface de linha de comando (CLI).

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.

Analise e atualize

O .NET Upgrade Assistant inclui um mecanismo de análise que verifica seus projetos e suas dependências. Após a conclusão da verificação, um relatório é gerado com informações detalhadas sobre como executar uma atualização. Você pode usar essas informações para atualizar todo o projeto ou partes específicas do projeto.

Tipos de projetos suportados

O .NET Upgrade Assistant oferece suporte à atualização de projetos codificados em C# ou Visual Basic. São apoiados os seguintes tipos de projetos:

  • ASP.NET
  • Funções do Azure
  • Arquitectura de Apresentação do Windows
  • Windows Forms
  • Bibliotecas de classes
  • Aplicações de consola
  • Formulários Xamarin
  • .NET MAUI
  • UWP nativa do .NET

Alguns produtos fornecem orientação sobre como usar o Assistente de Atualização do .NET.

Caminhos de atualização

Os seguintes caminhos de atualização são suportados:

  • .NET Framework para .NET
  • .NET Core para .NET
  • Azure Functions v1-v3 para v4 em modo isolado (direcionado para net6.0+)
  • UWP para WinUI 3
  • Versão anterior do .NET para a versão mais recente do .NET
  • Formulários Xamarin para .NET MAUI
    • As transformações de arquivo XAML suportam apenas a atualização de namespaces. Para transformações mais abrangentes, utilize o Visual Studio 2022 ou versões posteriores.

Detalhes e opções de atualização

Quando uma atualização é iniciada, um assistente orienta você na configuração de algumas das opções antes que a atualização seja iniciada. Com base no tipo de projeto que você está atualizando, o assistente apresenta diferentes opções. Para obter um exemplo de atualização de um projeto, consulte Atualizar projetos com o Assistente de Atualização do .NET.

Como a atualização deve ser executada

Com base no tipo de projeto que você está atualizando, talvez seja possível alterar a forma como a atualização é executada. O tipo de projeto afeta quais opções estão disponíveis, e um ou mais dos seguintes itens podem estar faltando:

  • Atualização de projeto no local

    Esta opção atualiza seu projeto sem fazer uma cópia.

  • Atualização simultânea do projeto

    Copia o seu projeto e atualiza a cópia, mantendo o seu projeto original inalterado.

  • Incremental lado a lado

    Esta é uma boa escolha para aplicações Web complicadas. A atualização do ASP.NET para o ASP.NET Core requer bastante trabalho e, às vezes, refatoração manual. Este modo coloca um projeto .NET ao lado do projeto .NET Framework existente. Os pontos de extremidade são roteados através do projeto .NET, enquanto todas as outras chamadas são enviadas para o aplicativo .NET Framework.

    Este modo permite-lhe atualizar lentamente a sua aplicação de ASP.NET ou biblioteca peça por peça.

Resultados da atualização

Quando a atualização for concluída, uma tela de status será exibida mostrando todos os artefatos associados à atualização. Cada elemento de atualização pode ser ampliado para visualizar mais informações sobre o estado. A lista a seguir descreve os ícones de status:

  • Marca de verificação verde vazia: a ferramenta não encontrou nada sobre o artefato para atualizar.
  • Marca de verificação verde preenchida: O artefato foi atualizado e concluído com êxito.
  • Sinal de aviso amarelo: O artefato foi atualizado, mas há informações importantes que você deve considerar.
  • Red X: A atualização do artefato não foi bem-sucedida.

A guia Resultados de atualização do Assistente de atualização do .NET no Visual Studio.

Além disso, as ações executadas durante a atualização são registradas na janela Saída, sob a origem Assistente de Atualizações, conforme mostrado na imagem a seguir.

A janela de saída no Visual Studio mostrando os resultados do Assistente de Atualização do .NET.

Depois de atualizar seu projeto, teste-o completamente!

Conteúdos relacionados

  • Last updated on