使用 .NET 升级助手升级项目

本文的重点是提供使用 .NET 升级助手升级项目的基本步骤。 这涉及到启动升级并查看结果。 根据项目的复杂性,可能需要对代码执行手动更新。

某些项目类型具有有关升级的特定指导。 有关详细信息,请参阅 支持的项目类型

先决条件

升级 Visual Studio 中的项目

按照以下步骤在 Visual Studio 中升级项目。

  1. 备份代码。

  2. 打开“Visual Studio”。

  3. 打开项目或解决方案。

  4. 解决方案资源管理器窗口中,右键单击项目>升级

    Visual Studio 中的解决方案资源管理器窗口,显示项目的右键单击菜单。突出显示“升级”菜单项。

  5. “升级 ”选项卡中,选择适当的升级选项。

    根据项目类型和目标框架版本,将显示不同的选项。 下图显示了升级 .NET Framework 项目的Windows 窗体时的两个选项。 升级 .NET 项目时不会显示这些选项:

    Visual Studio 中的 .NET 升级助手欢迎屏幕。

    在此示例中,选择“ 将项目升级到较新的 .NET 版本”。

  6. 选择要如何执行升级。 选择 就地项目升级,然后选择“ 下一步”。

    某些项目可能仅提供单个选项。 有关这些选项的详细信息,请参阅 如何执行升级。

    显示“升级类型是什么”选择的 .NET 升级助手向导。突出显示“就地项目升级”,如“下一步”按钮所示。

  7. 选择目标框架,例如 .NET 8.0。 然后选择下一步

    .NET 升级助手向导显示“首选目标框架”选择的内容。突出显示了“.NET 8.0”,“下一步”按钮也突出显示。

  8. 选择要升级的组件,然后选择“升级” 选择

    显示“选择要升级的组件”选项的 .NET 升级助手向导。突出显示组件列表,如“升级选择”按钮一样。

  9. 升级完成后,会显示已处理项的列表。

    显示摘要屏幕的 .NET 升级助手向导。将列出升级处理的每个项目,并带有状态图标。

将列出升级处理的每个项目及其状态。 有关详细信息,请参阅 升级结果

从 CLI 升级项目

按照以下步骤使用终端升级项目。 .NET 全局工具是一种交互式工具,可指导你完成升级选项。 使用向上键向下键更改突出显示的选项,Enter 以运行该选项。 每个屏幕都提供了有关如何配置升级的选项。

  1. 备份代码。

  2. 打开终端并导航到包含要升级的解决方案或项目的文件夹。

  3. 若要启动该工具,请运行 upgrade-assistant upgrade 命令。

    系统会询问要升级的内容。 根据检测到的内容,某些选项可能会自动应用或完全丢失。

    显示 .NET 升级助手全局工具选项的初始屏幕的终端。系统询问了“要升级哪个项目”的问题。

  4. 如果找到多个项目,请选择其中一个项目,然后按 Enter

    按依赖项顺序升级项目。 例如,上图显示了两个项目: MatchingGameMatchingGame.LogicMatchingGame 依赖于 MatchingGame.Logic它,因此 MatchingGame.Logic 应首先升级。

  5. 如果可以选择更改 升级类型,请选择一个,然后按 Enter。 如果只有一个选项可用,则会自动选择该选项。

    有关这些选项的详细信息,请参阅 如何执行升级。

    提示

    如果已备份代码,则可以安全地选择 就地项目升级

  6. 选择目标框架(如 .NET 8.0),然后按 Enter

  7. 最后一个提示是确认,显示所选的所有选项。 按 Enter 开始升级。

    显示 .NET 升级助手全局工具选项摘要屏幕的终端。系统会要求用户继续。

  8. 升级完成后,会显示摘要。

    使用 .NET 升级助手全局工具时显示升级命令的结果的终端。