将基于 EF6 代码的模型移植到 EF Core

项目
08/24/2023

如果你已阅读所有说明且已准备好进行移植，请查看下面一些指南，它们可帮你入门。

安装 EF Core NuGet 包

要使用 EF Core，请针对要使用的数据库提供程序安装 NuGet 包。例如，如果以 SQL Server 为目标，则安装 Microsoft.EntityFrameworkCore.SqlServer。有关详细信息，请参阅数据库提供程序。

如果计划使用迁移，则还应安装 Microsoft.EntityFrameworkCore.Tools 包。

可将 EF6 NuGet 包 (EntityFramework) 保留在安装状态，因为 EF Core 和 EF6 可在同一应用程序中并排使用。但是，如果你不打算在应用程序的任何区域使用 EF6，则卸载此包将有助于就需注意的代码片段生成编译错误。

交换命名空间

在 EF6 中使用的大多数 API 位于 System.Data.Entity 命名空间（及相关的子命名空间）中。第一个代码更改是交换到 Microsoft.EntityFrameworkCore 命名空间。通常，你首先是处理已派生的上下文代码文件，然后从此处开始，在出现编译错误时处理这些错误。

上下文配置（连接等）

如配置数据库连接中所述，EF Core 检测连接到的数据库时操作更一目了然。你将需要替代已派生的上下文中的 OnConfiguring 方法，并使用数据库提供程序特定的 API 设置到数据库的连接。

大多数 EF6 应用程序将连接字符串存储在应用程序 App/Web.config 文件中。在 EF Core 中，你将使用 ConfigurationManager API 读取此连接字符串。你可能还需要添加对 System.Configuration 框架程序集的引用才能使用此 API。

public class BloggingContext : DbContext
{
    public DbSet<Blog> Blogs { get; set; }
    public DbSet<Post> Posts { get; set; }

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
      optionsBuilder.UseSqlServer(ConfigurationManager.ConnectionStrings["BloggingDatabase"].ConnectionString);
    }
}

更新代码

此时，需要处理编译错误并检查代码，以查看行为变化是否会对你产生影响。

现有迁移

目前没有一种可行的方法可将现有 EF6 迁移移植到 EF Core。

如果可能，最好假设之前来自 EF6 的所有迁移都已应用到数据库，然后再使用 EF Core 从此处开始迁移架构。为此，一旦模型移植到 EF Core，即可使用 Add-Migration 添加迁移。然后，需已设置基架的迁移的 Up 和 Down 方法中删除所有代码。设置初始迁移的基架后，后续迁移将与此模型进行比较。

测试移植

你的应用程序进行了编译，并不意味着它会成功移植到 EF Core。需要测试应用程序的所有区域，确保行为变化都未对你的应用程序产生负面影响。

最后，请查看移植时要考虑的详细情况，以获得有关代码中特定情况和方案的更多建议。

通过