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 restante 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:

1. Remover referência a System.Web no arquivo de projeto
2. Adicione o pacote Microsoft.AspNetCore.SystemWebAdapters
3. Habilite o multi-targeting e adicione um destino .NET 6 ou posterior, ou converta o projeto para o .NET Standard 2.0.
4. 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.