Entity Framework Core

**Entity Framework Core**
开发者	Microsoft
稳定版本	1.1.1 （2017年2月17日）
预览版本	2.0.0-preview1 （2017年5月10日）
编程语言	C#
类型	开放源代码、资料访问
许可协议	Apache License 2.0
网站	GitHub、文件库

Entity Framework Core 是微软新一代的对象关联对应 (ORM) 框架，以 .NET Core 实作，不过它是归属于 ASP.NET Core 专案的一部分，在 ASP.NET Core 开始开发时就被列入标准功能，与现行的 Entity Framework 一样，是微软官方建议使用的资料访问功能，但 .NET Core 成功移植 ADO.NET 基础类别库 System.Data 之后，开发人员仍能使用 ADO.NET 作为资料访问的解决方案。

核心功能

Entity Framework Core 基本上以 ORM 架构为主，延续 Entity Framework 的作法发展，但 Entity Framework Core 不再支持 Database First 与 Model First 模式，而仅支持 Code First 模式，亦即使用程序码来处理 Model 以及资料库纲要对应的工作。

Entity Framework Core 1.0.0 目前支持下列功能 ^[1]：

资料库塑模 (Modeling)：使用 POCO 方式创建 Model 与其关联性、影子状态 (Shadow State) 属性维护、唯一性限制与索引、内建转换、模型验证、键值自动产生与关联-表格对应等。
变更追踪 (Change Tracking)：快照式变更追踪、访问已追踪的状态与附加已解除附加的资料项目或对象结构 (graph)。
储存功能 (Save Changes)：基本资料储存功能、乐观式锁定、异步变更储存、交易能力与批量处理。
查询 (Query)：基本 LINQ 的支持、混合式主从架构评估、关闭追踪功能、早期加载、异步查询、基本 BCL 函数的转换与 SQL 指令的执行。
资料库纲要管理 (Database Schema Management)：资料库创建与删除的 API 支持、资料库错误页面 (由 ASP.NET Core 提供) 与关联性资料库移转等。

目前正在实作中的有：

资料库塑模 (Modeling)：资料标记 (Entity Framework 时代的 Data Annotations) 与 TPH 继承模式。
分工的质量 (Cross-cutting quality)：文件、Intellisense 文件与 API 检阅。
性能 (Performance)：额外的性能覆盖与性能增进。
查询 (Query)：对关联属性的查询转换。
资料库的反向工程 (类似于 EF 的 Database First)。
稳定化对 Mac 与 Linux 的功能。
新的资料提供者。

在 1.0.0 内计划的功能有：

设计时期脉络 (context) 的发现与加载。
部署能力。
串联式删除。
记录功能。

资料提供者

Entity Framework Core 支持下列资料提供者 ^[2]：

SQL Server
SQLite
In-Memory (记忆体内资料库)，可供不需要访问到关联性资料库的测试工作。
PostgreSQL
SQL Server Compact
IBM 资料库服务器
MySQL

开发方式

Entity Framework Core 的开发方式与原有 Entity Framework 不同的是，Entity Framework Core 不再支持以 UI 为主的资料库组态 (这是为了要适应 Linux 与 Mac 的开发环境)，且不论是何种模式 (Database First / Code First)，都是以程序码为主的环境对应，不再有 EDMX (Entity Framework Metadata) 存在，为达成这个目标，Entity Framework 提供了 Scaffold-Database 指令 (于 Package Management Console 中执行)，允许开发人员由资料库来产生 Model 的程序码。

Scaffold-DbContext "'Server=(localdb)\mssqllocaldb;Database=Blogging;Trusted_Connection=True;''" Microsoft.EntityFrameworkCore.SqlServer

原本 Entity Framework 现有的资料模型同步指令 Add-Migration 与 Update-Database 在 Entity Framework Core 仍然支持，包含前述的 Scaffold-Database 指令，都被包装在 Microsoft.EntityFrameworkCore.Tools 包内，可以由 Package Management Console 中执行 Install-Package 安装它，或是直接编辑 project.json 将它加入相依包，然后再于 project.json 中加入工具的相关设定：

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

若是使用 Scaffold-Database 指令探测资料库时，除了 Model 会自动产生外，也会一并产生 DbContext 类别的派生程序，作为链接资料库的入口，若是由新资料库，或是未使用 Scaffold-Database 指令的话，就要自行撰写这个类别。

using Microsoft.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore.Metadata;

namespace EFGetStarted.AspNetCore.ExistingDb.Models
{
    public partial class BloggingContext : DbContext
    {
        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
        {
        }

        protected override void OnModelCreating(ModelBuilder modelBuilder)
        {
            modelBuilder.Entity<Blog>(entity =>
            {
                entity.Property(e => e.Url).IsRequired();
            });

            modelBuilder.Entity<Post>(entity =>
            {
                entity.HasOne(d => d.Blog)
                    .WithMany(p => p.Post)
                    .HasForeignKey(d => d.BlogId);
            });
        }

        public virtual DbSet<Blog> Blog { get; set; }
        public virtual DbSet<Post> Post { get; set; }
    }
}

就可以使用 DbContext 来操作资料库了，之后的部分就和 Entity Framework 差异不大。若是 ASP.NET Core，则需再到 ASP.NET Core 的起始类别 (例如 Startup.cs)，将 Entity Framework Core 的 DbContext 加到 Dependency Injection 里面。

public void ConfigureServices(IServiceCollection services)
{
    var connection = @"Server=(localdb)\mssqllocaldb;Database=Blogging;Trusted_Connection=True;";
    services.AddDbContext<BloggingContext>(options => options.UseSqlServer(connection));
    // ...
}

之后就可以由 Controller 获取这个 DbContext 进行资料访问的动作了，例如：

using EFGetStarted.AspNetCore.ExistingDb.Models;
using Microsoft.AspNetCore.Mvc;
using System.Linq;

namespace EFGetStarted.AspNetCore.ExistingDb.Controllers
{
    public class BlogsController : Controller
    {
        private BloggingContext _context;

        public BlogsController(BloggingContext context)
        {
            _context = context;
        }

        public IActionResult Index()
        {
            return View(_context.Blog.ToList());
        }

        public IActionResult Create()
        {
            return View();
        }

        [HttpPost]
        [ValidateAntiForgeryToken]
        public IActionResult Create(Blog blog)
        {
            if (ModelState.IsValid)
            {
                _context.Blog.Add(blog);
                _context.SaveChanges();
                return RedirectToAction("Index");
            }

            return View(blog);
        }

    }
}

参考

↑ Roadmap. [2016-03-13].
↑ Database Providers. [2016-03-13].

[1] Roadmap. [2016-03-13].

[2] Database Providers. [2016-03-13].

[1]

[2]