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:
- Remover referência a
System.Web
no 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.
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários