Skip to content

Latest commit

 

History

History
36 lines (27 loc) · 2.38 KB

File metadata and controls

36 lines (27 loc) · 2.38 KB
title description author ms.author ms.date uid
Learn to upgrade from ASP.NET MVC and Web API to ASP.NET Core MVC
Learn how to upgrade an ASP.NET MVC Framework or Web API project to ASP.NET Core MVC
rick-anderson
riande
03/07/2017
migration/mvc

Upgrade from ASP.NET MVC and Web API to ASP.NET Core MVC

:::moniker range=">= aspnetcore-7.0"

This article shows how to upgrade an ASP.NET Framework MVC or Web API app to ASP.NET Core MVC using the Visual Studio .NET Upgrade Assistant and the incremental update approach.

Upgrade using the .NET Upgrade Assistant

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.

  1. Install the .NET Upgrade Assistant Visual Studio extension.
  2. Open the ASP.NET MVC or Web API solution in Visual Studio.
  3. 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.
  4. For the upgrade target, select New project.
  5. Name the project and select the template. If the project you're migrating is a API project, select ASP.NET Core Web API. If it's an MVC project or MVC and Web API, select ASP.NET Core MVC.
  6. Select Next
  7. Select the target framework version and then select Next. For more information, see .NET and .NET Core Support Policy.
  8. Review the Summary of changes, then select Finish.
  9. The Summary step displays <Framework Project> is now connected to <Framework ProjectCore> via Yarp proxy. and a pie chart showing the migrated endpoints. Select Upgrade Controller and then select a controller to upgrade.
  10. Select the component to upgrade, then select Upgrade selection.

Incremental update

Follow the steps in Get started with incremental ASP.NET to ASP.NET Core migration to continue the update process.

:::moniker-end

[!INCLUDE]