1. Normal & Simple
先介绍一种最简单的构建方式,人人都会。
-
新建 Console 应用程序,命名自定
-
安装相关Nuget 包
//Sql Server Database ProviderInstall-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 InitializeUpdate-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将提示以下错误
No parameterless constructor was found on 'MyContext'. Either add a parameterless constructor to 'MyContext' or add an implementation of 'IDbContextFactory' in the same assembly as 'MyContext'.
添加无参构造器的方式之后再讲解,先来按照提示信息添加一个 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(); } }
这个工具类的使用方式就不再赘述了。