Introdução ao uso da migração incremental do ASP.NET para o ASP.NET Core
Para uma migração grande, recomendamos a configuração de 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 Migração incremental do ASP.NET para o ASP.NET Core. O rest deste artigo fornece as etapas para prosseguir com uma migração incremental.
Configurar o Projeto ASP.NET Core
Para aplicativos ASP.NET MVC e API Web, consulte Aprenda a atualizar do ASP.NET MVC e API Web para o ASP.NET Core MVC. Para aplicativos ASP.NET Framework Web Forms, consulte Aprenda a atualizar do ASP.NET Web Forms para o ASP.NET Core.
Atualizar as 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. O Assistente de Atualização é uma ótima ferramenta para isso. Se as bibliotecas não puderem ter como destino o .NET Standard, você poderá ter como destino o .NET 6 ou posterior, juntamente com o destino do .NET Framework no projeto original ou em um novo projeto junto com o original.
Os adaptadores podem ser usados nessas bibliotecas para permitir o suporte ao uso de System.Web.HttpContext em bibliotecas de classes. Para habilitar o uso de System.Web.HttpContext em uma biblioteca:
- Remover referência a
System.Webno arquivo de projeto - Adicione o pacote
Microsoft.AspNetCore.SystemWebAdapters - Habilite o multi-targeting e adicione um destino .NET 6 ou posterior, ou converta o projeto para o .NET Standard 2.0.
- Certifique-se de que a estrutura de destino seja compatível com o .NET Core. O multi-targeting pode ser usado se o .NET Standard 2.0 não for suficiente
Essa etapa pode exigir a alteração de vários projetos, dependendo da estrutura de sua solução. O Assistente de Atualização pode ajudá-lo a identificar quais precisam ser alterados e automatizar várias etapas do processo.
Habilitar Suporte à Sessão
A sessão é um recurso comumente usado do ASP.NET que compartilha o nome com um recurso do ASP.NET Core, mas as APIs são muito diferentes. Consulte a documentação sobre suporte à sessão.
Habilitar o suporte à autenticação compartilhada
É possível compartilhar a autenticação entre o aplicativo ASP.NET original e o novo aplicativo ASP.NET Core usando o recurso de autenticação remota de adaptadores System.Web. Esse recurso permite que o aplicativo ASP.NET Core adie a autenticação para o aplicativo ASP.NET. Consulte os documentos sobre conexão de aplicativo remoto e autenticação remota para obter mais detalhes.
Diretrizes Gerais de Uso
Há várias diferenças entre o ASP.NET e o ASP.NET Core que os adaptadores podem ajudar a atualizar. No entanto, há alguns recursos que exigem uma adesão, pois incorrem em algum custo. Há também comportamentos que não podem ser adaptados. Consulte diretrizes de uso para obter uma lista desses itens.
