Aan de slag met incrementele ASP.NET naar ASP.NET Core-migratie
Voor een grote migratie raden we u aan om een ASP.NET Core-app in te stellen die proxy's naar de oorspronkelijke .NET Framework-app uitvoeren. De nieuwe proxy-app wordt weergegeven in de volgende afbeelding:
Zie Incrementele migratie van ASP.NET naar ASP.NET Coreom te begrijpen hoe deze aanpak nuttig is in het migratieproces. De rest van dit artikel bevat de stappen om door te gaan met een incrementele migratie.
ASP.NET Core Project instellen
Voor ASP.NET MVC- en Web-API-apps, zie Leer om te upgraden van ASP.NET MVC en Web API naar ASP.NET Core MVC. Voor ASP.NET Framework Web Forms-apps, zie Leer hoe u ASP.NET Web Forms kunt upgraden naar ASP.NET Core.
Ondersteunende bibliotheken upgraden
Als u ondersteunende bibliotheken in uw oplossing hebt die u moet gebruiken, moeten ze indien mogelijk worden bijgewerkt naar .NET Standard 2.0. upgradeassistent is hiervoor een uitstekend hulpmiddel. Als bibliotheken zich niet kunnen richten op .NET Standard, kunt u .NET 6 of hoger instellen, samen met het .NET Framework-doel in het oorspronkelijke project of in een nieuw project naast het oorspronkelijke project.
De -adapters kunnen in deze bibliotheken worden gebruikt om ondersteuning voor System.Web.HttpContext gebruik in klassebibliotheken mogelijk te maken. Als u System.Web.HttpContext gebruik in een bibliotheek wilt inschakelen:
- Verwijzing naar
System.Webverwijderen in het projectbestand - Het
Microsoft.AspNetCore.SystemWebAdapters-pakket toevoegen - Schakel meerdere doelen in en voeg een .NET 6-doel of hoger toe of converteer het project naar .NET Standard 2.0.
- Zorg ervoor dat het doelframework .NET Core ondersteunt. Multi-targeting kan worden gebruikt als .NET Standard 2.0 niet voldoende is
Deze stap kan vereisen dat er meerdere projecten worden aangepast, afhankelijk van uw oplossingsstructuur. Met de upgradeassistent kunt u bepalen welke stappen u moet wijzigen en automatiseren in het proces.
Sessieondersteuning inschakelen
De sessie is een veelgebruikte functie van ASP.NET die de naam deelt met een functie in ASP.NET Core. Echter, de API's zijn heel anders. Zie de documentatie over sessie-ondersteuning.
Ondersteuning voor gedeelde verificatie inschakelen
Het is mogelijk om verificatie te delen tussen de oorspronkelijke ASP.NET-app en de nieuwe ASP.NET Core-app met behulp van de functie voor externe verificatie van System.Web adapters. Met deze functie kan de ASP.NET Core-app verificatie uitstellen voor de ASP.NET-app. Zie de externe app-verbinding en externe verificatie documenten voor meer informatie.
Algemene richtlijnen voor gebruik
Er zijn een aantal verschillen tussen ASP.NET en ASP.NET Core die de adapters kunnen helpen bij te werken. Er zijn echter enkele functies waarvoor een opt-in is vereist, omdat er kosten in rekening worden gebracht. Er zijn ook gedragingen die niet kunnen worden aangepast. Zie gebruiksrichtlijnen voor een lijst met deze informatie.
