移植代码的先决条件

在开始移植代码之前,对生成和运行 .NET 应用程序进行所需的更改。 这些更改可以在生成和运行 .NET Framework 应用程序的同时完成。

重要

.NET 升级助手已正式弃用。 使用 GitHub Copilot 现代化聊天代理 ,其包含在 Visual Studio 2026 和 Visual Studio 2022 17.14.16 或更高版本中。 此工具分析您的项目和依赖项,生成一个包含针对性建议和自动代码修复的分步迁移计划,并提交每个更改,以便您可以验证或回滚。 它自动执行常见移植任务(更新项目文件、替换已弃用的 API 和解决生成问题),以便可以更快地进行现代化,只需更少的手动工作量即可实现现代化。

升级到必需的工具

升级到支持要面向的 .NET 版本的 MSBuild/Visual Studio 版本。 有关详细信息 ,请参阅 .NET SDK、MSBuild 和 VS 之间的版本控制关系

更新 .NET Framework 目标版本

建议将 .NET Framework 应用定向到版本 4.7.2 或更高版本。 这可确保在 .NET Standard 不支持现有 API 的情况下提供最新的 API 替代项。

对于要移植的每个项目,在 Visual Studio 中执行以下作:

  1. 右键单击项目并选择“ 属性”。
  2. “目标框架 ”下拉列表中,选择 .NET Framework 4.7.2
  3. 重新编译项目。

由于项目现在面向 .NET Framework 4.7.2,因此请使用该版本的 .NET Framework 作为移植代码的基础。

更改为 PackageReference 格式

将所有引用转换为 PackageReference 格式。

转换为 SDK 样式项目格式

将项目转换为 SDK 样式格式

更新依赖项

将依赖项更新到其可用最新版本,并尽可能更新到 .NET Standard 版本。

后续步骤