Skip to content

Commit 672b415

Browse files
Copilotwadepickett
andcommitted
Replace Upgrade Assistant content with GitHub Copilot app modernization guidance
Co-authored-by: wadepickett <[email protected]>
1 parent ea8fd62 commit 672b415

File tree

3 files changed

+14
-37
lines changed

3 files changed

+14
-37
lines changed

aspnetcore/migration/fx-to-core/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -90,4 +90,4 @@ Incremental migration is an implementation of the Strangler Fig pattern and is b
9090

9191
## In place migration
9292

93-
In place migration can work for sufficiently small applications. If possible, this allows for a quick replacement of the application. However, small issues may be compounded if you decide to do an in place migration. See <xref:migration/fx-to-core/tooling> to learn how Upgrade Assistant can help with an in place migration.
93+
In place migration can work for sufficiently small applications. If possible, this allows for a quick replacement of the application. However, small issues may be compounded if you decide to do an in place migration. See <xref:migration/fx-to-core/tooling> for information on migration tooling options.

aspnetcore/migration/fx-to-core/start.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -147,15 +147,15 @@ Depending on your application, you may also need to address:
147147
148148
**Upgrade process for each library:**
149149

150-
If you have supporting libraries in your solution that you will need to use for the routes you're migrating, they should be upgraded to .NET Standard 2.0, if possible. [Upgrade Assistant](https://github.com/dotnet/upgrade-assistant) is a great tool for this. If libraries are unable to target .NET Standard, you can target .NET 8 or later either along with the .NET Framework target in the original project or in a new project alongside the original.
150+
If you have supporting libraries in your solution that you will need to use for the routes you're migrating, they should be upgraded to .NET Standard 2.0, if possible. If libraries are unable to target .NET Standard, you can target .NET 8 or later either along with the .NET Framework target in the original project or in a new project alongside the original.
151151

152152
The [System.Web adapters](~/migration/fx-to-core/inc/systemweb-adapters.md) can be used in these libraries to enable support for <xref:System.Web.HttpContext> usage in class libraries. In order to enable <xref:System.Web.HttpContext> usage in a library:
153153

154154
1. Remove reference to `System.Web` in the project file
155155
2. Add the `Microsoft.AspNetCore.SystemWebAdapters` package
156156
3. Enable multi-targeting and add a .NET 8 target or later, or convert the project to .NET Standard 2.0.
157157

158-
This step may require a number of projects to change depending on your solution structure and which routes you're migrating. Upgrade Assistant can help you identify which ones need to change and automate a number of steps in the process.
158+
This step may require a number of projects to change depending on your solution structure and which routes you're migrating.
159159

160160

161161
## Next Steps
Lines changed: 11 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -1,47 +1,24 @@
11
---
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
43
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.
55
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
78
uid: migration/fx-to-core/tooling
89
---
910
# Use tooling to help migrate ASP.NET Framework to ASP.NET Core
1011

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.
1214
15+
This article provides guidance on how to upgrade ASP.NET Framework applications (MVC, Web API, and Web Forms) to ASP.NET Core.
1316

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).
1818

1919
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).
2020

21+
## See also
2122

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

Comments
 (0)