使用工具帮助将 ASP.NET Framework 迁移到 ASP.NET Core

本文介绍如何使用 Visual Studio .NET 升级助手增量更新 方法将 ASP.NET 框架应用程序(MVC、Web API 和 Web 窗体)升级到 ASP.NET Core。

警告

有一个启用了 Copilot 的工具可以帮助保持与现代 .NET 的同步,但目前尚未启用迁移 ASP.NET Framework 到 ASP.NET Core 的功能。 有关详细信息,请参阅 GitHub Copilot 应用现代化的文档 - 升级 .NET

先决条件

如果 .NET Framework 项目在解决方案中具有所需的支持库,则应将其升级到 .NET Standard 2.0(如果可能)。 有关详细信息,请参阅 升级支持库

  1. 安装 .NET 升级助手 Visual Studio 扩展。

  2. 在 Visual Studio 中打开 ASP.NET 框架解决方案。

  3. 解决方案资源管理器中,右键单击要升级的项目,然后选择“ 升级”。 选择 并行增量项目升级,这是唯一的升级选项。

  4. 对于升级目标,请选择“ 新建项目”。

  5. 命名项目并选择最合适的模板。 如果解决方案包含多个项目类型,可以稍后添加所需的服务:

    注释

    对于 MVC 项目: 选择 ASP.NET 核心 MVC 模板。

    对于 Web API 项目: 选择 ASP.NET 核心 Web API 模板。

    对于 MVC + Web API 项目: 选择 ASP.NET 核心 MVC 模板。

    对于 Web 窗体项目: 选择 ASP.NET 核心 模板。

  6. 选择“下一步”

  7. 选择目标框架版本,然后选择“ 下一步”。 有关详细信息,请参阅 .NET 和 .NET Core 支持策略

    注释

    对于 Web 窗体项目: 选择 “完成 ”而不是 “下一步”,然后继续执行步骤 9。

  8. 查看 更改摘要,然后选择“ 完成”。

  9. “摘要”步骤显示<Framework Project>现在通过 Yarp 代理连接到<Framework ProjectCore>

    注释

    对于 MVC 和 Web API 项目: 摘要包含显示已迁移终结点的饼图。 选择 “升级控制器 ”,然后选择要升级的控制器。 选择要升级的组件,然后选择“ 升级”选择