Comece com a migração incremental de ASP.NET para ASP.NET Core
Para uma migração grande, recomendamos configurar um aplicativo ASP.NET Core que faça proxy para o aplicativo .NET Framework original. O novo aplicativo habilitado para proxy é mostrado na imagem a seguir:
Para entender como essa abordagem é útil no processo de migração, consulte Incremental ASP.NET to ASP.NET Core migration. O restante deste artigo fornece as etapas para prosseguir com uma migração incremental.
Configurar projeto ASP.NET Core
Para aplicativos ASP.NET MVC e API Web, consulte Aprenda a atualizar de ASP.NET MVC e API Web para ASP.NET Core MVC. Para aplicativos ASP.NET Framework Web Forms, consulte Aprenda a atualizar de ASP.NET Web Forms para ASP.NET Core.
Atualizar bibliotecas de suporte
Se você tiver bibliotecas de suporte em sua solução que precisará usar, elas deverão ser atualizadas para o .NET Standard 2.0, se possível. Upgrade Assistant é uma ótima ferramenta para isso. Se as bibliotecas não puderem visar o .NET Standard, pode-se visar o .NET 6 ou posterior juntamente com o destino do .NET Framework no projeto original ou num novo projeto paralelamente ao original.
Os adaptadores podem ser usados nessas bibliotecas para habilitar o suporte para uso System.Web.HttpContext em bibliotecas de classe. Para habilitar o uso do System.Web.HttpContext numa biblioteca:
- Remover referência a
System.Webno arquivo de projeto - Adicionar o pacote
Microsoft.AspNetCore.SystemWebAdapters - Habilitar múltiplos destinos e adicionar um alvo .NET 6 ou posterior, ou converter o projeto para o .NET Standard 2.0.
- Verifique se a estrutura de destino oferece suporte ao .NET Core. Multi-targeting pode ser usado se o .NET Standard 2.0 não for suficiente
Esta etapa pode exigir que vários projetos sejam alterados, dependendo da estrutura da solução. O Assistente de Atualização pode ajudá-lo a identificar quais precisam ser alterados e automatizar várias etapas do processo.
Ativar suporte de sessão
Session é um recurso comumente usado do ASP.NET que compartilha o nome com um recurso no ASP.NET Core as APIs são muito diferentes. Consulte a documentação referente ao suporte para sessões .
Habilitar suporte à autenticação compartilhada
É possível partilhar a autenticação entre a aplicação ASP.NET original e a nova aplicação ASP.NET Core usando a funcionalidade de autenticação remota dos adaptadores System.Web. Esse recurso permite que o aplicativo ASP.NET Core adie a autenticação para o aplicativo ASP.NET. Consulte os documentos de conexão de aplicativo remoto e de autenticação remota para obter mais detalhes.
Orientações gerais de utilização
Há uma série de diferenças entre ASP.NET e ASP.NET Core que os adaptadores são capazes de ajudar a atualizar. No entanto, existem alguns recursos que exigem um opt-in, pois incorrem em algum custo. Há também comportamentos que não podem ser adaptados. Consulte as diretrizes de uso em para obter uma lista destes.
