|
1 | 1 | --- |
2 | | -title: Learn to upgrade from ASP.NET MVC, Web API, and Web Forms to ASP.NET Core |
3 | | -description: Learn how to upgrade ASP.NET Framework MVC, Web API, or Web Forms projects to ASP.NET Core using migration tooling |
| 2 | +ai-usage: ai-assisted |
4 | 3 | author: wadepickett |
| 4 | +description: Learn how to upgrade ASP.NET Framework MVC, Web API, or Web Forms projects to ASP.NET Core using migration tooling. |
5 | 5 | ms.author: wpickett |
6 | | -ms.date: 07/17/2025 |
| 6 | +ms.date: 12/04/2025 |
| 7 | +title: Learn to upgrade from ASP.NET MVC, Web API, and Web Forms to ASP.NET Core |
7 | 8 | uid: migration/fx-to-core/tooling |
8 | 9 | --- |
9 | 10 | # Use tooling to help migrate ASP.NET Framework to ASP.NET Core |
10 | 11 |
|
11 | | -This article shows how to upgrade ASP.NET Framework applications (MVC, Web API, and Web Forms) to ASP.NET Core using the Visual Studio [.NET Upgrade Assistant](https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.upgradeassistant) and the [incremental update](xref:migration/fx-to-core/index) approach. |
| 12 | +> [!IMPORTANT] |
| 13 | +> .NET Upgrade Assistant is officially deprecated. Use the [GitHub Copilot app modernization chat agent](/dotnet/core/porting/github-copilot-app-modernization/overview) instead, which is included with Visual Studio 2026 and Visual Studio 2022 17.14.16 or later. This agent analyzes your projects and dependencies, produces a step-by-step migration plan with targeted recommendations and automated code fixes, and commits each change so you can validate or roll back. It automates common porting tasks—updating project files, replacing deprecated APIs, and resolving build issues—so you can modernize faster with less manual effort. |
12 | 14 |
|
| 15 | +This article provides guidance on how to upgrade ASP.NET Framework applications (MVC, Web API, and Web Forms) to ASP.NET Core. |
13 | 16 |
|
14 | | - > [!WARNING] |
15 | | - > There is a Copilot-enabled tool for staying current on modern .NET, but is not currently enabled for migrating ASP.NET Framework to ASP.NET Core. Please see the documentation for [GitHub Copilot app modernization - Upgrade for .NET](/dotnet/core/porting/github-copilot-app-modernization-overview) for details. |
16 | | -
|
17 | | -## Prerequisites |
| 17 | +To learn how to upgrade your ASP.NET apps using the recommended tooling, see [How to upgrade a .NET app with GitHub Copilot app modernization](/dotnet/core/porting/github-copilot-app-modernization/how-to-upgrade-with-github-copilot). |
18 | 18 |
|
19 | 19 | If your .NET Framework project has supporting libraries in the solution that are required, they should be upgraded to .NET Standard 2.0, if possible. For more information, see [Upgrade supporting libraries](xref:migration/fx-to-core/start#upgrade-supporting-libraries). |
20 | 20 |
|
| 21 | +## See also |
21 | 22 |
|
22 | | -1. Install the [.NET Upgrade Assistant](https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.upgradeassistant) Visual Studio extension. |
23 | | -1. Open your ASP.NET Framework solution in Visual Studio. |
24 | | -1. In **Solution Explorer**, right click on the project to upgrade and select **Upgrade**. Select **Side-by-side incremental project upgrade**, which is the only upgrade option. |
25 | | -1. For the upgrade target, select **New project**. |
26 | | -1. Name the project and select the most appropriate template. If your solution includes multiple project types, you may add the required services later: |
27 | | - |
28 | | - > [!NOTE] |
29 | | - > **For MVC projects:** Select **ASP.NET Core MVC** template. |
30 | | - > |
31 | | - > **For Web API projects:** Select **ASP.NET Core Web API** template. |
32 | | - > |
33 | | - > **For MVC + Web API projects:** Select **ASP.NET Core MVC** template. |
34 | | - > |
35 | | - > **For Web Forms projects:** Select **ASP.NET Core** template. |
36 | | -
|
37 | | -1. Select **Next** |
38 | | -1. Select the target framework version and then select **Next**. For more information, see [.NET and .NET Core Support Policy](https://dotnet.microsoft.com/platform/support/policy/dotnet-core). |
39 | | - |
40 | | - > [!NOTE] |
41 | | - > **For Web Forms projects:** Select **Done** instead of **Next**, then proceed to step 9. |
42 | | -
|
43 | | -1. Review the **Summary of changes**, then select **Finish**. |
44 | | -1. The **Summary** step displays **`<Framework Project>` is now connected to `<Framework ProjectCore>` via Yarp proxy.** |
45 | | - |
46 | | - > [!NOTE] |
47 | | - > **For MVC and Web API projects:** The summary includes a pie chart showing the migrated endpoints. Select **Upgrade Controller** and then select a controller to upgrade. Select the component to upgrade, then select **Upgrade selection**. |
| 23 | +* [GitHub Copilot app modernization overview](/dotnet/core/porting/github-copilot-app-modernization/overview) |
| 24 | +* [How to upgrade a .NET app with GitHub Copilot app modernization](/dotnet/core/porting/github-copilot-app-modernization/how-to-upgrade-with-github-copilot) |
0 commit comments