前言

EntityFramework Core 1.0 即原来的EF7.0更名,从.Net Framework平台向.Net Core平台的更新.
吐槽一下,既然.Net Framework更名为.Net Core的话,EntityFramework为啥不更名为EntityCore,弄得名字越来越长,多打9个字母也累啊.

官方资料

项目地址:https://github.com/aspnet/EntityFramework
官方文档:https://docs.efproject.net/en/latest/platforms/coreclr/index.html

关于本笔记

本笔记会以Ubuntu平台开发,数据库采用多种数据库(包括Sqlite,SQL Server和Npgsql),并在Github上提供源码.
为了纯粹学习EntityFramework Core(以下简称EFCore),代码将以Console形式开发,剥离掉ASP.NET等部分.
开始之前，先下载所需要的包

• .Net Core安装参考：http://www.jianshu.com/p/36c601d27efa
• Sqlite的Ubuntu驱动：

 $ sudo apt-get install libsqlite3-dev

关于本篇

本篇将简单构建一个EFCore应用程序，并插入一条数据。

创建EFCore Console项目

$ dotnet new
Created new C# project in /home/yotsuki/code/EFCoreLearn/learn01.

修改配置文件

在project.json的dependencies节点中加入引用,

 \"Microsoft.EntityFrameworkCore\": \"1.0.0-rc2-final\",
 \"Microsoft.EntityFrameworkCore.Sqlite\": \"1.0.0-rc2-final\",
 \"Microsoft.EntityFrameworkCore.Tools\": {
   \"type\":\"build\",
   \"version\": \"1.0.0-preview1-final\"
 },

并在framework中加入\”portable-net452+win81\”

  \"frameworks\": {
    \"netcoreapp1.0\": {
      \"imports\": [\"dnxcore50\",\"portable-net452+win81\"]
      }
  },

这里我们先用Sqlite为例子，修改完成后，输入命令

$ dotnet restore

将自动下载所需要的包，如果是第一次下载，会比较慢，请耐心等待

添加一个DbContext

新建一个文件SqliteContext.cs

using Microsoft.EntityFrameworkCore;
public class SqliteContext:DbContext
{
    public SqliteContext():base(){}
    public SqliteContext(DbContextOptions options) : base(options) { }
}

我们在使用EF6.x的时候，DbContext默认会读取App.config/Web.config中配置的同名连接字符串。但在EFCore中并不如此。由于.NET Core是一个真正模块化的平台,读取配置文件也需要自己去引用包。
这里我先按照官方文档中提供的方法写入连接字符串

1. 调用前传入

        var builder = new DbContextOptionsBuilder();
        builder.UseSqlite(\"Filename=./learn01.db\");
        using (var context = new SqliteContext(builder.Options)) {
            //...
        }

2. 重写DbContext的OnConfiguring方法

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        optionsBuilder.UseSqlite(\"Filename=./learn01.db\");
    }

   添加一个实体

   新建一个实体类User.cs

    public class User
    {
        public Guid ID { get; set; }
        public string Name { get; set; }
        public string Password { get; set; }
    }

   并将实体加入SqliteContext中

    public DbSet Users { get; set; }

   添加迁移

   迁移功能(Migration)在EF6.x已经有了，CodeFirst开发中迁移功能可以方便的进行数据库模型的变更。
   在EF6.x中，Sqlite的驱动并不支持迁移，通常我们需要自己去写一个迁移功能。但这次EFCore提供的Sqlite驱动已经能够进行迁移了。
   要使用迁移功能需要先在project.json中添加工具支持

    \"tools\": {
        \"Microsoft.EntityFrameworkCore.Tools\": {
            \"imports\": [ \"portable-net451+win8\" ],
            \"version\": \"1.0.0-preview1-final\"
        }
    },

   再restore后就可以使用命令了

    $ dotnet restore
    $ dotnet ef -h

Paste_Image.png

使用migrations add命令来添加迁移

$ dotnet ef migrations add Init
Project learn01 (.NETCoreApp,Version=v1.0) was previously compiled. Skipping compilation.
Done. To undo this action, use \'ef migrations remove\'

此命令对应EF6.x的Add-Migration命令
添加迁移完成后，会在项目目录中新建一个Migrations目录和相应的迁移类
和EF6.X一样,AddMigration之后需要update才会体现到数据库中

$ dotnet ef database update
Project learn01 (.NETCoreApp,Version=v1.0) was previously compiled. Skipping compilation.
Applying migration \'20160526075826_Init\'.
Done.

完成迁移，我们来看下数据库

Paste_Image.png

数据库生成在bin/Debug/netcoreapp1.0/ 目录下
其中包含两个表，“Users”和\”__EFMigrationsHistory\”表。“Users”不用多说，就是我们添加的实体表。
\”__EFMigrationsHistory\”是迁移记录表，查询一下可以看到，其中已经有了一条数据，对应着我们本次的迁移。
EFCore的迁移记录相对与EF6.x简单了一些，这里我推断EFCore并没有根据Model改变的一些操作。
下图是EF6.1.2的迁移记录表，对比一下就发现目前EFCore的设计更加纯粹

Paste_Image.png

简单的添加一条记录

接下来，我们要为数据库添加第一条记录
我们修改Program.cs

    public static void Main(string[] args)
    {
        using (var context = new SqliteContext()) {
            context.Users.Add(new User(){ Name=\"yotsuki\",Password=\"123456\"});
            var result = context.SaveChanges();
            if (result > 0) {
                Console.WriteLine(\"1 row installed.\");
            }else {
                Console.WriteLine(\"install failed.\");
            }
        }
    }

然后运行命令

$ dotnet build 
$ dotnet run
Project learn01 (.NETCoreApp,Version=v1.0) was previously compiled. Skipping compilation.
1 row installed.

我们再看下数据库

Paste_Image.png

一条数据已插入(Guid因为是二进制存储,显示有一些问题)

其他数据库

Sql Server

在project.json添加引用

\"Microsoft.EntityFrameworkCore.SqlServer\": \"1.0.0-rc2-final\",

在OnConfiguring方法中修改

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        optionsBuilder.UseSqlServer(/*连接字符串*/);
    }

Npgsql

在project.json添加引用

\"Npgsql.EntityFrameworkCore.PostgreSQL\": \"1.0.0-rc2-final\",

在OnConfiguring方法中修改

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        optionsBuilder.UseNpgsql(/*连接字符串*/);
    }