浅谈 EF CORE 迁移和实例化的几种方式

出于学习和测试的简单需要，使用 Console 来作为 EF CORE 的承载程序是最合适不过的。今天笔者就将平时的几种使用方式总结成文，以供参考，同时也是给本人一个温故知新的机会。因为没有一个完整的脉络，所以也只是想起什么写点什么，不通顺的地方还请多多谅解。

1. Normal & Simple

先介绍一种最简单的构建方式，人人都会。

新建 Console 应用程序，命名自定

安装相关Nuget 包

//Sql Server Database Provider
Install-Package Microsoft.EntityFrameworkCore.SqlServer

//提供熟悉的Add-Migration，Update-Database等Powershell命令，不区分关系型数据库类型
Install-Package Microsoft.EntityFrameworkCore.Tools

自定义 DbContext

public class MyContext:DbContext
{
protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
optionsBuilder.UseSqlServer("Server=(localdb)\\mssqllocaldb;Database=ConsoleApp;Trusted_Connection=True;MultipleActiveResultSets=true;");
}
}

执行迁移和更新命令

Add-Migration Initialize
Update-Database

使用方式

using (var context = new MyContext())
{
// TODO
}

刚以上，我们便见识到了了一种最平常也是最简单的使用方式，接下来，让我们用其他方式去慢慢地改造它，从而尽可能地接触更多的用法。

2. Level Up

2.1 准备工作

将第一步生成的数据库，迁移文件和使用方式内容全部删除。

2.2 更新 MyContext 内容

删除 MyContext 中的 OnConfiguring 方法及其内容，增加含有 DbContextOptions 类型参数的构造器，我们的MyContext看起来应该是下面这个样子。

public class MyContext : DbContext
{
public MyContext(DbContextOptions options) : base(options)
{
}
}

假如我们此时仍然再执行迁移命令，VS将提示以下错误


添加无参构造器的方式之后再讲解，先来按照提示信息添加一个 IDbContextFactory 的实现类。

public class MyContextFactory : IDbContextFactory<MyContext>
{
public MyContext Create(DbContextFactoryOptions options)
{
var optionsBuilder = new DbContextOptionsBuilder<MyContext>();
optionsBuilder.UseSqlServer("Server=(localdb)\\mssqllocaldb;Database=ConsoleApp;Trusted_Connection=True;MultipleActiveResultSets=true;");

return new MyContext(optionsBuilder.Options);
}
}

之后再次运行迁移和更新数据库的命令也是水到渠成。

2.3 使用方式：构造器实例化

既然 MyContext 含有 DbContextOptions 类型参数的构造器，那就手动创建一个参数实例注入即可。

var contextOptionsBuilder = new DbContextOptionsBuilder<MyContext>();
contextOptionsBuilder.UseSqlServer("Server=(localdb)\\mssqllocaldb;Database=ConsoleApp;Trusted_Connection=True;MultipleActiveResultSets=true;");

// 注入配置选项
using (var context = new MyContext(contextOptionsBuilder.Options))
{
// TODO
}

经此，我们知道了迁移命令会检测 Context 的相关配置入口，只有在满足存在 OnConfiguring 方法或者存在自建 IDbContextFactory 实现类的情况下，命令才能成功运行。

3. Day Day Up

目前为止，我们已经知道如何手动迁移和实例化 Context 的步骤了所以让我们更进一步。写过 ASP.NET CORE 的人可能知道在 ASP.NET CORE 中，Context 常常以依赖注入的方式引入到我们的 Web 层，Service 层，或者 XXCore 层中（话说笔者最近最喜欢的解决方案开发架构就是伪 DDD 的四层架构，有空再介绍吧）。其实在 Console 应用中，这也可以很容易实现，具体的依赖注入引入可以参考笔者的上一篇博客，所以最终的代码效果如下：

var serviceCollection = new ServiceCollection();
serviceCollection.AddDbContext<MyContext>(c =>
{
c.UseSqlServer("Server=(localdb)\\mssqllocaldb;Database=ConsoleApp;Trusted_Connection=True;MultipleActiveResultSets=true;");
});

var serviceProvider = serviceCollection.BuildServiceProvider();

using (var context = serviceProvider.GetService<MyContext>())
{
//context.Database.Migrate();
}

至此，我们便基本完成了本文的主题，唯一有些美中不足的是我们的数据库连接字符串好像到处都是，这不是什么大问题，笔者直接将 Configuration 的配置代码贴在下面，这也是 ABP 中的方式。

public class AppConfigurations
{
private static readonly ConcurrentDictionary<string, IConfigurationRoot> ConfigurationCache;

static AppConfigurations()
{
ConfigurationCache = new ConcurrentDictionary<string, IConfigurationRoot>();
}

public static IConfigurationRoot Get(string environmentName = null)
{
var cacheKey = "#" + environmentName;
return ConfigurationCache.GetOrAdd(
cacheKey,
_ => BuildConfiguration(environmentName)
);
}

private static IConfigurationRoot BuildConfiguration(string environmentName = null)
{
var builder = new ConfigurationBuilder()
.SetBasePath(Directory.GetCurrentDirectory())
.AddJsonFile("appsettings.json", true, true);

if (!string.IsNullOrWhiteSpace(environmentName))
builder = builder.AddJsonFile($"appsettings.{environmentName}.json", true);

builder = builder.AddEnvironmentVariables();

return builder.Build();
}
}

这个工具类的使用方式就不再赘述了。

4. 结尾

最后，想必会有人问为什么要折腾这样一个小小的 Console 应用呢？其实通过这样一步步下来，我们可以发现一些项目功能上的亮点，比如既然可以自配置 DbContext 的 Option 选项，同时我们也知道了如何在类库和 Console 项目中添加依赖注入以及 Configuration 提取链接参数的功能，那针对三层架构或是 DDD 项目增加含真实数据库或是内存数据库（InMemory）的单元测试，或者是自动Migrate Context 和更新数据库也将是十分简单的一件事，至少看起来会比官方的示例更加真实和具有可操作性。而这部分内容笔者也将会在之后的博文中给出。

我的博客即将搬运同步至腾讯云+社区，邀请大家一同入驻：https://cloud.tencent.com/developer/support-plan